==============================================================================
HSARTK: AR Marker Detection Plug-in for Hot Soup Processor (HSP).

version 0.1.0

Copyright (C) 2008 ちょくと (fresh_homepie)
chokutto@yahoo.co.jp
==============================================================================


■ HSARTK について

 HSARTKは、ARToolkitによる拡張現実感プログラミングをHSPで実現するため
 の拡張プラグインです。どういうものかはオリジナルARToolkitのサンプルを
 いじってみるとわかります。(...手抜き説明)

オリジナルのARToolkitの機能のうちマーカー検出機能のみを提供しています。
カメラ映像キャプチャや3Dイメージは他の拡張プラグインを使用する必要が
あります。(キャプチャに hspcv, 3D表示に hgimg3 など)
また、マルチマーカーの検出機能はありません。

使い方は添付のHSPサンプルスクリプトを参照してください。
(命令リファレンスはいずれ作成するかもしれませんが、現状はありません)



本拡張プラグインにはARToolkitを使用しています。

ARToolkit 
http://www.hitl.washington.edu/artoolkit/


本拡張プラグインには NyARTransMat C version for original ARToolKit を
使用しています。

NyARTransMat C version for original ARToolKit
http://nyatla.jp/nyartoolkit/wiki/index.php?NyARTransMat_C_version



■ 開発環境

 Visual C++ 2008 Express Edition のコンパイル環境が含まれています。


■ 動作環境(サンプルプログラム実行環境)

 Hot Soup Processor (HSP) 3.2 がインストールされた環境
 DirectX 8 以上がインストールされていること
 Webカメラを使用可能であること

 Hot Soup Processor 公式ページ「HSPTV!」
 http://hsp.tv/


■ ディレクトリ構成

./ARToolkit
  HSARTK が利用するARToolkitライブラリのサブセットが含まれます。
  (オリジナルの ARToolkit のうち libAR プロジェクトのみ)

./bin
  HSARTK拡張プラグイン本体 (hsartk.dll) が含まれます。
  サンプルをHSPエディタ上から実行させるには、あらかじめDLLを
  HSPインストールフォルダにコピーしておく必要があります。
  サンプルからEXEファイルを作成して実行するには、EXEファイル
  と同じフォルダにDLLをコピーしておく必要があります。

./src
  HSARTKのソースファイルが含まれます。
  (NyARTransMat C version for original ARToolKit、および
   HSP拡張プラグイン開発用ヘッダファイルを含む)

./hsp_sample
  HSPのヘッダ(hsartk.as)と、サンプルスクリプトが含まれます。
  実行にはオリジナルARToolkitに含まれている「hiro」マーカー
  が必要です。別途ダウンロードして印刷してください。
  実行にはWebカメラが必要です。カメラによっては映像の上下が
  逆転する可能性があります。その場合はスクリプトの「cvflip」
  の行をコメントアウトしてください。


■ ライセンス
 ARToolkit のライセンスに従い、HSARTK 拡張プラグインは GPLv2 で
 利用できます。

 GPL
  GPLではソフトウェアのバイナリを第三者に公開する場合に、
  そのソフトウェアを構成するすべてのソースファイルを、
  GPLライセンスで公開しなければならない制約があります。
  詳しくは添付の COPYING.txt を参照してください。


 srcディレクトリに含まれる hspvar_core.h および hspwnd.h は、
 修正BSDライセンスの元で利用が認められているものです。
 詳しくは添付の HSPLicense.txt を参照してください。



■ 更新履歴

  ○ 0.1.0 (2009.09.22)

    ・とりあえず公開。
