readme.ja.txt

   1 ARToolKit Java class library NyARToolkit.\r
   2 Copyright (C)2008 R.Iizuka\r
   3 \r
   4 version 2.2.0\r
   5 \r
   6 http://nyatla.jp/nyartoolkit/\r
   7 airmail(at)ebony.plala.or.jp\r
   8 --------------------------------------------------\r
   9 \r
  10 \r
  11 \r
  12 \r
  13 ・NyARToolkit/2.2\r
  14 \r
  15 NyARToolkitは、Pure Javaで実装したARToolKitクラスライブラリです。\r
  16 \r
  17 ARToolKit 2.72.1をベースに構築されています。\r
  18 \r
  19 NyARToolkit/2.0系はNyARToolkit/1.xと比較して、処理速度と可読性、\r
  20 モジュールの分離性が向上しています。\r
  21 \r
  22 \r
  23 \r
  24 J2SEでのみ動作を確認しました。\r
  25 J2MEやMIDP2.0にはそのうち対応します。\r
  26 \r
  27 \r
  28 ARToolkitは加藤博一先生とHuman Interface Technology Labにより\r
  29 開発されたAugmented Reality (AR) ライブラリです。\r
  30 詳しくはこちらをご覧下さい。\r
  31 http://www.hitl.washington.edu/artoolkit/\r
  32 \r
  33 \r
  34 ・NyARToolkitの特徴\r
  35 \r
  36 　-ARToolKitと同等な処理シーケンスを、クラスベースで再構築してあります。\r
  37 \r
  38   -構造的な最適化により、ARToolKitと比較して可読性に優れています。\r
  39 \r
  40 　-座標変換の演算性能が1.5倍ほど高速です。（JIT有効時）複数マーカー取り扱い時は、\r
  41 　 オリジナルよりも良い成績が得られます。\r
  42 \r
  43 　-取り扱える画像サイズに制限がありません。\r
  44 \r
  45 　-取り扱えるマーカー個数の最大値が可変です。\r
  46 \r
  47 \r
  48 \r
  49 \r
  50 \r
  51 \r
  52 ・構成\r
  53 \r
  54 +-----------------------------------------------+\r
  55 |                   Application                 |\r
  56 +-------+---------+--------+--------+-----------+\r
  57 |NyARJMF|CaptureQT| NyARJoglNyARJ3d |           |\r
  58 +-------+---------+--------+--------+           |\r
  59 |  JMF  |QuickTime|  JOGL  | Java3D |NyARToolkit|\r
  60 +-------+---------+--------+--------+           |\r
  61 |      Camera     |       3D        |           |\r
  62 ------------------------------------+-----------+\r
  63 \r
  64 \r
  65 映像キャプチャにはJMF、又はQuickTimeを使用することが出来ます。\r
  66 \r
  67 3D描画にはJOGL又はJava3Dを使用することが出来ます。\r
  68 \r
  69 NyARJMF/CaptureQT/NyARJog/NyARJ3dは、下位のキャプチャモジュール\r
  70 や3Dライブラリを使いやすくするためのラッパークラス群です。\r
  71 \r
  72 各モジュールとNyARToolkitは容易に分離可能であり、個々を単独で\r
  73 使用することも可能です。\r
  74 \r
  75 \r
  76 \r
  77 \r
  78 ・サンプルなど\r
  79 \r
  80 １．動作させる前に、JMFとJOGLかJava3Dをインストールしてください。\r
  81 　　QuickTimeを使う場合には、QuickTime for Javaも必要です。\r
  82 \r
  83 \r
  84 動作確認したバージョンと入手先はこちらです。\r
  85 \r
  86 JMF JavaTM Media Framework 2.1.1e\r
  87 http://java.sun.com/products/java-media/jmf/index.jsp\r
  88 \r
  89 jogl-1.1.1-pre-20080328-xxxx-i586.zip\r
  90 https://jogl.dev.java.net/\r
  91 \r
  92 java3d-1_5_1-xxxx-i586.exe\r
  93 https://java3d.dev.java.net/binary-builds.html\r
  94 \r
  95 QuickTime 7.5\r
  96 http://www.apple.com/quicktime/qtjava/\r
  97 \r
  98 \r
  99 \r
 100 ２．eclipseで空のワークスペースを作成し、sample,src,src.utils\r
 101 　　ディレクトリをインポートしてください。\r
 102 \r
 103 srcディレクトリには、NyARToolkit本体（計算クラス群）があります。\r
 104 src.utilsディレクトリには、カメラキャプチャクラスや、3Dライブラリ用のラッパークラス群があります。\r
 105 sampleディレクトリには、NyARToolkitを使用したサンプルプログラムがあります。\r
 106 \r
 107 \r
 108 ・プロジェクトの説明\r
 109 \r
 110 ライブラリ\r
 111 \r
 112 NyARToolkit\r
 113 　NyARToolkitライブラリの本体です。依存する外部モジュールはありません。\r
 114 \r
 115 NyARToolkit.utils.jmf\r
 116 　JMFからの画像をNyARToolkitに取り込むクラス群があります。\r
 117 　外部ライブラリは、JMFに依存します。\r
 118 \r
 119 NyARToolkit.utils.qt\r
 120 　QuickTimeからの画像をNyARToolkitに取り込むクラス群があります。\r
 121 　外部ライブラリは、JMF、QuickTime for Javaに依存します。\r
 122 \r
 123 NyARToolkit.utils.jogl\r
 124 　OpenGLとNyARToolkitのインタフェイスクラス群があります。\r
 125 　外部ライブラリは、JMF,JOGLに依存します。\r
 126 \r
 127 NyARToolkit.utils.java3d\r
 128 　Java3DとNyARToolkitのインタフェイスクラス群があります。\r
 129 　外部ライブラリは、JMF,Java3Dに依存します。\r
 130 \r
 131 \r
 132 サンプル\r
 133 \r
 134 NyARToolkit.sample.jogl\r
 135 　JOGL/JMFを使ったサンプルプログラムがあります。\r
 136 \r
 137   -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite\r
 138    単一のマーカーを認識するARToolkitのsimpleLite相当のサンプルです。\r
 139   -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite2\r
 140    複数のマーカーを認識するサンプルです。～100個程度のマーカーを同時に\r
 141    認識します。\r
 142 \r
 143 \r
 144 NyARToolkit.sample.java3d\r
 145 　JOGL/JMFを使ったサンプルプログラムです。\r
 146 　\r
 147   -jp.nyatla.nyartoolkit.java3d.sample\r
 148   simpleLiteをJava3Dで動かすサンプルがあります。\r
 149 \r
 150 NyARToolkit.sample.jmf\r
 151   JMFを使ったサンプルプログラムです。\r
 152 \r
 153   -jp.nyatla..nyartoolkit.jmf.sample\r
 154 　JMFでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。\r
 155 　\r
 156 \r
 157 NyARToolkit.sample.qt\r
 158 　Quicktime for Javaを使ったサンプルプログラムです。\r
 159 \r
 160 　-jp.nyatla.nyartoolkit.qt.sample\r
 161 　QuickTimeでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。\r
 162 　\r
 163 \r
 164 \r
 165 \r
 166 \r
 167 ・足りない機能等\r
 168 \r
 169 カメラキャリブレーション、マーカーのセーブ機能等が相変わらずありません。\r
 170 今後実装していきます。\r
 171 \r
 172 \r
 173 \r
 174 \r
 175 ・ライセンス\r
 176 GPLv2以降です。詳しくはLICENCE.txtをみてください。\r
 177 ソースコード毎のライセンスは、各ソースファイルを参照してください。\r
 178 \r
 179 \r
 180 \r
 181 \r
 182 ・謝辞\r
 183 \r
 184 arc@dmzさん\r
 185 http://digitalmuseum.jp/\r
 186 \r
 187 QuickTimeキャプチャモジュールを提供をして頂きました。有難うございます。