﻿ARToolkit Java class library NyARToolkit.
Copyright (C)2008 R.Iizuka

version Alpha 0.5.20080329.0

http://nyatla.jp/
airmail(at)ebony.plala.or.jp
--------------------------------------------------




・NyARToolkit

NyARToolkitは、nativeなコードを一切使用しない、Pure Javaのみで
構成されたARToolkitクラスライブラリです。

ARToolkit 2.72.0をベースに構築されています。

J2SEでのみ動作を確認しました。
J2MEやMIDP2.0にはそのうち対応します。




・基本構成

+----------------------------
|       Application         |
+-------+-------+-----------+
|NyARJMF| NyJogl|           |
+-------+-------+           |
|  JMF  |  JOGL |NyARToolkit|
+-------+-------+           |
|Camera |  3D   |           |
----------------------------+

映像キャプチャにはJMFを使用し、3D描画にはJoglを使用しています。
NyARJMFとNyJoglは、これらのエクステンションをApplicationやNyARToolKit
から使いやすくするためのラッパーです。

これらとNyARToolkitは完全に分離していますので、入力・出力ともに容易に
差し替えが出来ると思います。




・サンプルなど

動作させる前に、JMFとJOGLをインストールしてください。
動作確認したバージョンと入手先はこちらです。

JMF JavaTM Media Framework 2.1.1e
http://java.sun.com/products/java-media/jmf/index.jsp

jogl-1.1.1-pre-20080328-windows-i586.zip
https://jogl.dev.java.net/


サンプルは以下のディレクトリにあります。

./src
NyARToolkitのEclipseプロジェクトがあります。
jp.nyatla.nyartoolkit.sampleパッケージに、Rawイメージから
変換行列を求めるサンプルがあります。

./sample
NyARToolkitのアプリケーションサンプルEclipseプロジェクトがあります。
NyARJMFにはビデオキャプチャの試験プログラムと、マーカー検出プログラムがあります。
NyARJOGLにはARToolkitのsimpleLite相当のサンプルがあります。

NyARJMFのプロジェクトはNyARToolKitに依存し、NyARJOGLのプロジェクトはNyARToolKit
とNyARJMFに依存しています。
zipを展開すると多分参照関係が壊れてますので、再設定してください。




・NyARToolkitとオリジナルの差分

オリジナルと演算結果に互換性がありますが、関数構成を再設計した
ため、関数名や関数コールの手順の互換性がほとんどありません。

クラスは関数機能毎にまとめた作りになっていますので、オリジナルの
コード読んだことがあれば、なんとなく判ると思います。




・足りない機能等

マーカーのセーブ機能と、複数マーカーの認識機能が未実装です。

今後実装していきます。




・ライセンス
GPLです。詳しくはLICENCE.txtをみてください。




・お願い

NyARToolkitを使って面白いものが出来たら、是非教えてください。

それと強制では有りませんが、NyARToolkitを使った感想などを
送ってくれると、今後の励みになります。




ではでは、楽しく遊んでくださいネ。

2008.03.29 R.Iizuka@nyatla.jp
