-ARToolkit Java class library NyARToolkit.\r
+ARToolKit Java class library NyARToolkit.\r
Copyright (C)2008 R.Iizuka\r
\r
-version 1.0.0.20080428.0\r
+version 2.1.0\r
\r
-http://nyatla.jp/\r
+http://nyatla.jp/nyartoolkit/\r
airmail(at)ebony.plala.or.jp\r
--------------------------------------------------\r
\r
\r
\r
\r
-・NyARToolkit\r
+・NyARToolkit/2.1\r
+\r
+NyARToolkitは、Pure Javaで実装したARToolKitクラスライブラリです。\r
+\r
+ARToolKit 2.72.1をベースに構築されています。\r
+\r
+NyARToolkit/2.0系は、NyARToolkit/1.xと比較して構造的な最適化がされており、\r
+可読性と分離性が向上しています。\r
\r
-NyARToolkitは、nativeなコードを一切使用しない、Pure Javaのみで\r
-構成されたARToolkitクラスライブラリです。\r
\r
-ARToolkit 2.72.1をベースに構築されています。\r
\r
J2SEでのみ動作を確認しました。\r
J2MEやMIDP2.0にはそのうち対応します。\r
http://www.hitl.washington.edu/artoolkit/\r
\r
\r
+・NyARToolkitの特徴\r
+\r
+ -ARToolKitと同等な処理シーケンスを、クラスベースで再構築してあります。\r
+\r
+ -構造的な最適化がされており、ARToolKitと比較して可読性に優れています。\r
+\r
+ -座標変換の演算性能が1.5倍ほど高速です。（JIT有効時）複数マーカー取り扱い時は、\r
+ オリジナルよりも良い成績が得られます。\r
+\r
+ -取り扱える画像サイズに制限がありません。\r
+\r
+ -取り扱えるマーカー個数の最大値が可変です。\r
+\r
+\r
+\r
+\r
+\r
\r
・構成\r
\r
-+-------------------------------------------+\r
-| Application |\r
-+-------+---------+-------+-----------------+\r
-|NyARJMF| NyARJogl|NyARJ3d| |\r
-+-------+---------+-------+ |\r
-| JMF | JOGL |Java3D |Java3DNyARToolkit|\r
-+-------+---------+-------+ |\r
-|Camera | 3D | |\r
---------------------------------------------+\r
++-----------------------------------------------+\r
+| Application |\r
++-------+---------+--------+--------+-----------+\r
+|NyARJMF|CaptureQT| NyARJoglNyARJ3d | |\r
++-------+---------+--------+--------+ |\r
+| JMF |QuickTime| JOGL | Java3D |NyARToolkit|\r
++-------+---------+--------+--------+ |\r
+| Camera | 3D | |\r
+------------------------------------+-----------+\r
+\r
\r
-映像キャプチャにはJMFを使用し、3D描画にはJOGL又はJava3Dを使用しています。\r
-NyARJMFとNyJogl,NyJ3dは、これらのエクステンションをApplicationや\r
-NyARToolKitから使いやすくするためのラッパーです。\r
+映像キャプチャにはJMF、又はQuickTimeを使用することが出来ます。\r
\r
-これらとNyARToolkitは完全に分離していますので、入力・出力ともに容易に\r
-差し替えが出来ると思います。\r
+3D描画にはJOGL又はJava3Dを使用することが出来ます。\r
+\r
+NyARJMF/CaptureQT/NyARJog/NyARJ3dは、下位のキャプチャモジュール\r
+や3Dライブラリを使いやすくするためのラッパークラス群です。\r
+\r
+これらとNyARToolkitは疎結合になっており、インタフェイスをあわせる\r
+ことで、自作モジュール等との差し替えが出来ます。\r
\r
\r
\r
\r
・サンプルなど\r
\r
-動作させる前に、JMFとJOGLかJava3Dをインストールしてください。\r
+１．動作させる前に、JMFとJOGLかJava3Dをインストールしてください。\r
+ QuickTimeを使う場合には、QuickTime for Javaも必要です。\r
+\r
+\r
動作確認したバージョンと入手先はこちらです。\r
\r
JMF JavaTM Media Framework 2.1.1e\r
java3d-1_5_1-xxxx-i586.exe\r
https://java3d.dev.java.net/binary-builds.html\r
\r
+QuickTime 7.5\r
+http://www.apple.com/quicktime/qtjava/\r
\r
\r
-サンプルは以下のディレクトリにあります。\r
\r
-./src\r
- NyARToolkitのEclipseプロジェクトがあります。\r
- jp.nyatla.nyartoolkit.sampleパッケージに、Rawイメージから\r
- 変換行列を求めるサンプルがあります。\r
+２．eclipseで空のワークスペースを作成し、sample,src,src.utils\r
+ ディレクトリをインポートしてください。\r
\r
-./sample\r
-NyARToolkitのアプリケーションサンプルEclipseプロジェクトがあります。\r
+srcにはNyARToolkit本体、src.utilsにはキャプチャや3Dライブラリとの\r
+インタフェイスクラス群、sampleにはこれらを組み合わせた動作する\r
+サンプルプログラムがあります。\r
\r
- jmf\r
- jp.nyatla.nyartoolkit.jmf.sample\r
- ビデオキャプチャの試験プログラム と、マーカー検出プログラムがあります。\r
\r
- jogl\r
- jp.nyatla.nyartoolkit.jogl.sample\r
- ARToolkitのsimpleLite相当のサンプルがあります。\r
\r
- java3d\r
- jp.nyatla.nyartoolkit.java3d.sample\r
- simpleLiteのようなものをJava3Dで動かすサンプルがあります。\r
\r
+・プロジェクトの説明\r
\r
-NyARJMFのプロジェクトはNyARToolKitに依存し、NyARJOGLとJava3Dのプロジェクトは\r
-NyARToolKitとNyARJMFに依存しています。\r
-zipを展開すると多分参照関係が壊れてますので、再設定してください。\r
+ライブラリ\r
\r
+NyARToolkit\r
+ NyARToolkitライブラリの本体です。依存する外部モジュールはありません。\r
\r
+NyARToolkit.utils.jmf\r
+ JMFからの画像をNyARToolkitに取り込むクラス群があります。\r
+ 外部ライブラリは、JMFに依存します。\r
\r
-・サンプル内のパッケージ注意点\r
-sampleディレクトリ以下にあるソースはAPIは仕様が固まっていないので、\r
-時々APIそのものを変更しています。\r
+NyARToolkit.utils.qt\r
+ QuickTimeからの画像をNyARToolkitに取り込むクラス群があります。\r
+ 外部ライブラリは、JMF、QuickTime for Javaに依存します。\r
\r
-自前のプロジェクトの部品として使われる場合は、パッケージをコピーして\r
-使用することをお勧めします。\r
+NyARToolkit.utils.jogl\r
+ OpenGLとNyARToolkitのインタフェイスクラス群があります。\r
+ 外部ライブラリは、JMF,JOGLに依存します。\r
\r
+NyARToolkit.utils.java3d\r
+ Java3DとNyARToolkitのインタフェイスクラス群があります。\r
+ 外部ライブラリは、JMF,Java3Dに依存します。\r
\r
\r
-ã\83»NyARToolkitã\81¨ã\82ªã\83ªã\82¸ã\83\8aã\83«ã\81®å·®å\88\86\r
+ã\82µã\83³ã\83\97ã\83«\r
\r
-オリジナルと演算結果に互換性がありますが、関数構成を再設計した\r
-ã\81\9fã\82\81ã\80\81é\96¢æ\95°å\90\8dã\82\84é\96¢æ\95°ã\82³ã\83¼ã\83«ã\81®æ\89\8bé \86ã\81®äº\92æ\8f\9bæ\80§ã\81\8cã\81»ã\81¨ã\82\93ã\81©ã\81\82ã\82\8aã\81¾ã\81\9bã\82\93。\r
+NyARToolkit.sample.jogl\r
+ã\80\80JOGL/JMFã\82\92使ã\81£ã\81\9fã\82µã\83³ã\83\97ã\83«ã\83\97ã\83ã\82°ã\83©ã\83 ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99。\r
\r
-クラスは関数機能毎にまとめた作りになっていますので、オリジナルの\r
-コード読んだことがあれば、なんとなく判ると思います。\r
+ -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite\r
+ 単一のマーカーを認識するARToolkitのsimpleLite相当のサンプルです。\r
+ -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite2\r
+ 複数のマーカーを認識するサンプルです。～100個程度のマーカーを同時に\r
+ 認識します。\r
\r
-演算性能は、Windows環境下でVCリリース版の約85％です。\r
-マーカー認識部分はネイティブ版よりも低速ですが、変換行列計算部分\r
-はネイティブ版よりも高速に動作します。\r
\r
+NyARToolkit.sample.java3d\r
+ JOGL/JMFを使ったサンプルプログラムです。\r
+ \r
+ -jp.nyatla.nyartoolkit.java3d.sample\r
+ simpleLiteをJava3Dで動かすサンプルがあります。\r
\r
-・足りない機能等\r
+NyARToolkit.sample.jmf\r
+ JMFを使ったサンプルプログラムです。\r
\r
-マーカーのセーブ機能と、複数マーカーの認識機能が未実装です。\r
+ -jp.nyatla..nyartoolkit.jmf.sample\r
+ JMFでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。\r
+ \r
\r
-今後実装していきます。\r
+NyARToolkit.sample.qt\r
+ Quicktime for Javaを使ったサンプルプログラムです。\r
\r
+ -jp.nyatla.nyartoolkit.qt.sample\r
+ QuickTimeでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。\r
+ \r
\r
\r
\r
-・ライセンス\r
-GPLです。詳しくはLICENCE.txtをみてください。\r
\r
+・足りない機能等\r
+\r
+カメラキャリブレーション、マーカーのセーブ機能等が相変わらずありません。\r
+今後実装していきます。\r
\r
\r
\r
-・お願い\r
-NyARToolkitを使って面白いものが出来たら、是非教えてください。\r
\r
-それと強制では有りませんが、NyARToolkitを使った感想などを\r
-送ってくれると、今後の励みになります。\r
+・ライセンス\r
+GPLv2以降です。詳しくはLICENCE.txtをみてください。\r
+ソースコード毎のライセンスは、各ソースファイルを参照してください。\r
+\r
+\r
\r
\r
+・謝辞\r
\r
-ではでは、楽しく遊んでくださいネ。\r
+arc@dmzさん\r
+http://digitalmuseum.jp/\r
\r
-2008.04.28 R.Iizuka A虎＠nyatla.jp\r
+QuickTimeキャプチャモジュールを提供をして頂きました。有難うございます。
\ No newline at end of file
OSDN Git Service
