OSDN Git Service

[backup]NyARToolkit for Java
[nyartoolkit-and/nyartoolkit-and.git] / readme.ja.txt
index d2ed0f1..a4b6d29 100644 (file)
@@ -1,21 +1,21 @@
-ARToolkit Java class library NyARToolkit.\r
+ARToolKit Java class library NyARToolkit.\r
 Copyright (C)2008 R.Iizuka\r
 \r
-version Alpha 0.7.20080406.0\r
+version 2.4.0\r
 \r
-http://nyatla.jp/\r
+http://nyatla.jp/nyartoolkit/\r
 airmail(at)ebony.plala.or.jp\r
+wm(at)nyatla.jp\r
 --------------------------------------------------\r
 \r
 \r
 \r
 \r
-・NyARToolkit\r
+・NyARToolkit/2.4\r
 \r
-NyARToolkitは、nativeなコードを一切使用しない、Pure Javaのみで\r
-構成されたARToolkitクラスライブラリです。\r
+NyARToolkitは、Pure Javaで実装したARToolKitクラスライブラリです。\r
 \r
-ARToolkit 2.72.1をベースに構築されています。\r
+ARToolKit 2.72.1をベースに構築されています。\r
 \r
 J2SEでのみ動作を確認しました。\r
 J2MEやMIDP2.0にはそのうち対応します。\r
@@ -27,94 +27,179 @@ ARToolkitは加藤博一先生とHuman Interface Technology Labにより
 http://www.hitl.washington.edu/artoolkit/\r
 \r
 \r
+・NyARToolkitの特徴\r
 \r
-・基本構成\r
+ -ARToolKitと同等な処理シーケンスを、クラスベースで再構築しています。\r
 \r
-+-----------------------------+\r
-|         Application         |\r
-+-------+-------+-------------+\r
-|NyARJMF| NyARJogl|           |\r
-+-------+---------+           |\r
-|  JMF  |  JOGL   |NyARToolkit|\r
-+-------+---------+           |\r
-|Camera |  3D     |           |\r
-------------------------------+\r
+ -ARToolKitと比較して、処理構造が最適化されています。\r
 \r
-映像キャプチャにはJMFを使用し、3D描画にはJoglを使用しています。\r
-NyARJMFとNyJoglは、これらのエクステンションをApplicationやNyARToolKit\r
-から使いやすくするためのラッパーです。\r
+ -ARToolKit互換モードと、NyARToolkit最適化モードを搭載しています。(Version/2.4.0より)\r
+  \r
+  --NyARToolkit最適化モード\r
+    いくつかのアルゴリズムをARToolKitのものと差換え、高速化・精度の向上を図ります。\r
+    ARToolKit比で、約2倍高速です。(JIT有効時)複数マーカー取り扱い時は、\r
+    更に高速になります。ただし、計算結果はARToolKitのそれと若干ズレがでます。\r
 \r
-これらとNyARToolkitは完全に分離していますので、入力・出力ともに容易に\r
-差し替えが出来ると思います。\r
+  --ARToolKit互換モード\r
+    ARToolKitのアルゴリズムを最適化し、高速化を図ります。\r
+    ARToolKit比で、約1倍高速です。(JIT有効時)\r
+\r
+ -取り扱える画像サイズに制限がありません。\r
+ -取り扱えるマーカー個数の最大値が可変です。\r
+ -Idマーカシステム(NyId)が利用できます。(Version/2.3.0より)\r
+\r
+\r
+\r
+\r
+\r
+\r
+\r
+・構成\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、又はQuickTimeを使用することが出来ます。\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をインストールしてください。\r
+1.動作させる前に、JMFとJOGLかJava3Dをインストールしてください。\r
+  QuickTimeを使う場合には、QuickTime for Javaも必要です。\r
+\r
+\r
 動作確認したバージョンと入手先はこちらです。\r
 \r
 JMF JavaTM Media Framework 2.1.1e\r
 http://java.sun.com/products/java-media/jmf/index.jsp\r
 \r
-jogl-1.1.1-pre-20080328-windows-i586.zip\r
+jogl-1.1.1-pre-20080328-xxxx-i586.zip\r
 https://jogl.dev.java.net/\r
 \r
+java3d-1_5_1-xxxx-i586.exe\r
+https://java3d.dev.java.net/binary-builds.html\r
 \r
-サンプルは以下のディレクトリにあります。\r
+QuickTime 7.5\r
+http://www.apple.com/quicktime/qtjava/\r
 \r
-./src\r
-NyARToolkitのEclipseプロジェクトがあります。\r
-jp.nyatla.nyartoolkit.sampleパッケージに、Rawイメージから\r
-変換行列を求めるサンプルがあります。\r
 \r
-./sample\r
-NyARToolkitのアプリケーションサンプルEclipseプロジェクトがあります。\r
-NyARJMFにはビデオキャプチャの試験プログラムと、マーカー検出プログラムがあります。\r
-NyARJOGLにはARToolkitのsimpleLite相当のサンプルがあります。\r
 \r
-NyARJMFのプロジェクトはNyARToolKitに依存し、NyARJOGLのプロジェクトはNyARToolKit\r
-とNyARJMFに依存しています。\r
-zipを展開すると多分参照関係が壊れてますので、再設定してください。\r
+2.eclipseで空のワークスペースを作成し、sample,src,src.utils\r
+  ディレクトリをインポートしてください。\r
 \r
+srcディレクトリには、NyARToolkit本体(計算クラス群)があります。\r
+src.utilsディレクトリには、カメラキャプチャクラスや、3Dライブラリ用のラッパークラス群があります。\r
+sampleディレクトリには、NyARToolkitを使用したサンプルプログラムがあります。\r
 \r
 \r
+・プロジェクトの説明\r
 \r
\83»NyARToolkitã\81¨ã\82ªã\83ªã\82¸ã\83\8aã\83«ã\81®å·®å\88\86\r
\83©ã\82¤ã\83\96ã\83©ã\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©ありません。\r
+NyARToolkit\r
\80\80NyARToolkitã\83©ã\82¤ã\83\96ã\83©ã\83ªã\81®æ\9c¬ä½\93ã\81§ã\81\99ã\80\82ä¾\9då­\98ã\81\99ã\82\8bå¤\96é\83¨ã\83¢ã\82¸ã\83¥ã\83¼ã\83«ã\81¯ありません。\r
 \r
-クラスは関数機能毎にまとめた作りになっていますので、オリジナルの\r
-コード読んだことがあれば、なんとなく判ると思います。\r
+NyARToolkit.utils.jmf\r
+ JMFからの画像をNyARToolkitに取り込むクラス群があります。\r
+ 外部ライブラリは、JMFに依存します。\r
 \r
+NyARToolkit.utils.qt\r
+ QuickTimeからの画像をNyARToolkitに取り込むクラス群があります。\r
+ 外部ライブラリは、JMF、QuickTime for Javaに依存します。\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
 \r
-マーカーのセーブ機能と、複数マーカーの認識機能が未実装です。\r
+サンプル\r
+\r
+NyARToolkit.sample.jogl\r
+ JOGL/JMFを使ったサンプルプログラムがあります。\r
+\r
+  -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite\r
+   単一のARToolKit用マーカーを認識するARToolkitのsimpleLite相当のサンプルです。\r
+  -jp.nyatla.nyartoolkit.jogl.sample.JavaSimpleLite2\r
+   複数のARToolKit用マーカーを認識するサンプルです。1~100個程度のマーカーを\r
+   同時に認識します。\r
+  -jp.nyatla.nyartoolkit.jogl.sample.SingleNyIdMarker\r
+   単一のNyIdマーカを認識するためのサンプルです。アプリケーションフレームワーク\r
+   SingleNyIdMarkerProcesserのリファレンス実装です。\r
+\r
+\r
+NyARToolkit.sample.java3d\r
+ JOGL/JMFを使ったサンプルプログラムです。\r
+ \r
+  -jp.nyatla.nyartoolkit.java3d.sample\r
+   simpleLiteをJava3Dで動かすサンプルがあります。\r
+\r
+NyARToolkit.sample.jmf\r
+  JMFを使ったサンプルプログラムです。\r
+\r
+  -jp.nyatla..nyartoolkit.jmf.sample\r
+  JMFでキャプチャした画像をNyARToolkitで処理するサンプルプログラムです。\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
+・足りない機能等\r
 \r
+カメラキャリブレーション、マーカーのセーブ機能等が相変わらずありません。\r
 今後実装していきます。\r
 \r
 \r
 \r
 \r
 ・ライセンス\r
-GPLです。詳しくはLICENCE.txtをみてください。\r
 \r
+NyARToolkitは、商用ライセンスとGPLv3以降のデュアルライセンスを採用しています。\r
+(Version/2.4.0より、GPLv3ライセンスになりました。)\r
 \r
+ -GPL\r
+ GPLについては、LICENCE.txtをお読みください。\r
 \r
+ -商用ライセンス\r
+ 商用ライセンスについては、ARToolWorks社に管理を委託しております。\r
+ http://www.artoolworks.com/Home.html\r
 \r
-・お願い\r
-NyARToolkitを使って面白いものが出来たら、是非教えてください。\r
+ 日本国内での販売については、下記にお問い合わせ下さい。\r
+ http://www.msoft.co.jp/pressrelease/press090928-1.html\r
 \r
-それと強制では有りませんが、NyARToolkitを使った感想などを\r
-送ってくれると、今後の励みになります。\r
 \r
 \r
+・謝辞\r
 \r
-ではでは、楽しく遊んでくださいネ。\r
+arc@dmzさん\r
+http://digitalmuseum.jp/\r
 \r
-2008.03.29 R.Iizuka nyatla.jp\r
+QuickTimeキャプチャモジュールを提供をして頂きました。有難うございます。
\ No newline at end of file