readme.ja.txt

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