1 ARToolKit Java class library NyARToolkit.
\r
2 Copyright (C)2008-2010 Ryo Iizuka
\r
6 http://nyatla.jp/nyartoolkit/
\r
7 airmail(at)ebony.plala.or.jp
\r
9 --------------------------------------------------
\r
16 NyARToolkitは、Pure Javaで実装したARToolKitクラスライブラリです。
\r
18 ARToolKit 2.72.1をベースに構築されています。
\r
21 J2MEやMIDP2.0にはそのうち対応します。
\r
24 ARToolkitは加藤博一先生とHuman Interface Technology Labにより
\r
25 開発されたAugmented Reality (AR) ライブラリです。
\r
27 http://www.hitl.washington.edu/artoolkit/
\r
32 -ARToolKitと同等な処理シーケンスを、クラスベースで再構築しています。
\r
34 -ARToolKitと比較して、処理構造が最適化されています。
\r
36 -ARToolKit互換モードと、NyARToolkit最適化モードを搭載しています。(Version/2.4.0より)
\r
39 いくつかのアルゴリズムをARToolKitのものと差換え、高速化・精度の向上を図ります。
\r
40 ARToolKit比で、約2倍高速です。(JIT有効時)複数マーカー取り扱い時は、
\r
41 更に高速になります。ただし、計算結果はARToolKitのそれと若干ズレがでます。
\r
44 ARToolKitのアルゴリズムを最適化し、高速化を図ります。
\r
45 ARToolKit比で、約1倍高速です。(JIT有効時)
\r
47 -取り扱える画像サイズに制限がありません。
\r
48 -取り扱えるマーカー個数の最大値が可変です。
\r
49 -Idマーカシステム(NyId)が利用できます。(Version/2.3.0より)
\r
58 +-----------------------------------------------+
\r
60 +-------+---------+--------+--------+-----------+
\r
61 |NyARJMF|CaptureQT| NyARJoglNyARJ3d | |
\r
62 +-------+---------+--------+--------+ |
\r
63 | JMF |QuickTime| JOGL | Java3D |NyARToolkit|
\r
64 +-------+---------+--------+--------+ |
\r
66 ------------------------------------+-----------+
\r
70 映像キャプチャにはJMF、又はQuickTimeを使用することが出来ます。
\r
71 NyARJMF/CaptureQTは、各カメラライブラリのラッパークラス群です。
\r
74 3D描画にはJOGL又はJava3Dを使用することが出来ます。
\r
75 NyARJolg/NyARJ3dは、各3dライブラリへのラッパークラス群です。
\r
78 NyARToolkitの中核部は、機能毎に細分化された部品クラスと、それらを
\r
79 ユースケースに合せて動作させる管理クラスに分かれています。
\r
80 jp.nyatla.nyartoolkit.core下にあるクラスは部品クラス、その上位に
\r
81 あるものは、ユースケースごとの管理クラスです。
\r
87 1.動作させる前に、JMFとJOGLかJava3Dをインストールしてください。
\r
88 QuickTimeを使う場合には、QuickTime for Javaも必要です。
\r
91 動作確認したバージョンと入手先はこちらです。
\r
93 JMF JavaTM Media Framework 2.1.1e
\r
94 http://java.sun.com/products/java-media/jmf/index.jsp
\r
96 jogl-1.1.1-pre-20080328-xxxx-i586.zip
\r
97 https://jogl.dev.java.net/
\r
99 java3d-1_5_1-xxxx-i586.exe
\r
100 https://java3d.dev.java.net/binary-builds.html
\r
103 http://www.apple.com/quicktime/qtjava/
\r
107 2.eclipseで空のワークスペースを作成し、sample,src,src.utils
\r
108 ディレクトリをインポートしてください。
\r
110 srcディレクトリには、NyARToolkit本体(計算クラス群)があります。
\r
111 src.utilsディレクトリには、カメラキャプチャクラスや、3Dライブラリ
\r
113 sampleディレクトリには、NyARToolkitを使用したサンプルプログラムがあります。
\r
121 NyARToolkitライブラリの本体です。依存する外部モジュールはありません。
\r
123 NyARToolkit.utils.jmf
\r
124 JMFからの画像をNyARToolkitに取り込むクラス群があります。
\r
125 外部ライブラリは、JMFに依存します。
\r
127 NyARToolkit.utils.qt
\r
128 QuickTimeからの画像をNyARToolkitに取り込むクラス群があります。
\r
129 外部ライブラリは、JMF、QuickTime for Javaに依存します。
\r
131 NyARToolkit.utils.jogl
\r
132 OpenGLとNyARToolkitのインタフェイスクラス群があります。
\r
133 外部ライブラリは、JMF,JOGLに依存します。
\r
135 NyARToolkit.utils.java3d
\r
136 Java3DとNyARToolkitのインタフェイスクラス群があります。
\r
137 外部ライブラリは、JMF,Java3Dに依存します。
\r
142 NyARToolkit.sample.jogl
\r
143 JOGL/JMFを使ったサンプルプログラムがあります。
\r
145 -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite
\r
146 単一のARToolKit用マーカーを認識するARToolkitのsimpleLite相当のサンプルです。
\r
147 -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite2
\r
148 複数のARToolKit用マーカーを認識するサンプルです。1~100個程度のマーカーを
\r
150 -jp.nyatla.nyartoolkit.jogl.sample.SingleNyIdMarker
\r
151 単一のNyIdマーカを認識するためのサンプルです。アプリケーションフレームワーク
\r
152 SingleNyIdMarkerProcesserのリファレンス実装です。
\r
155 NyARToolkit.sample.java3d
\r
156 JOGL/JMFを使ったサンプルプログラムです。
\r
158 -jp.nyatla.nyartoolkit.java3d.sample
\r
159 simpleLiteをJava3Dで動かすサンプルがあります。
\r
161 NyARToolkit.sample.jmf
\r
162 JMFを使ったサンプルプログラムです。
\r
164 -jp.nyatla..nyartoolkit.jmf.sample
\r
165 JMFでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。
\r
167 NyARToolkit.sample.qt
\r
168 Quicktime for Javaを使ったサンプルプログラムです。
\r
170 -jp.nyatla.nyartoolkit.qt.sample
\r
171 QuickTimeでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。
\r
174 NyARToolkit.sandbox
\r
175 正式サポートされていない開発中の実験クラス群です。動作しないものもあります。
\r
182 カメラキャリブレーション、マーカーのセーブ機能等が相変わらずありません。
\r
190 NyARToolkitは、商用ライセンスとGPLv3以降のデュアルライセンスを採用しています。
\r
191 (Version/2.4.0より、GPLv3ライセンスになりました。)
\r
194 GPLについては、LICENCE.txtをお読みください。
\r
197 商用ライセンスについては、ARToolWorks社に管理を委託しております。
\r
198 http://www.artoolworks.com/Home.html
\r
200 日本国内での販売については、下記にお問い合わせ下さい。
\r
201 http://www.msoft.co.jp/pressrelease/press090928-1.html
\r
208 http://digitalmuseum.jp/
\r
210 QuickTimeキャプチャモジュールを提供をして頂きました。有難うございます。