readme.ja.txt

   1 ARToolkit Java class library NyARToolkit.\r
   2 Copyright (C)2008 R.Iizuka\r
   3 \r
   4 version Alpha 0.5.20080329.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.0をベースに構築されています。\r
  19 \r
  20 J2SEでのみ動作を確認しました。\r
  21 J2MEやMIDP2.0にはそのうち対応します。\r
  22 \r
  23 \r
  24 \r
  25 \r
  26 ・基本構成\r
  27 \r
  28 +----------------------------\r
  29 |       Application         |\r
  30 +-------+-------+-----------+\r
  31 |NyARJMF| NyJogl|           |\r
  32 +-------+-------+           |\r
  33 |  JMF  |  JOGL |NyARToolkit|\r
  34 +-------+-------+           |\r
  35 |Camera |  3D   |           |\r
  36 ----------------------------+\r
  37 \r
  38 映像キャプチャにはJMFを使用し、3D描画にはJoglを使用しています。\r
  39 NyARJMFとNyJoglは、これらのエクステンションをApplicationやNyARToolKit\r
  40 から使いやすくするためのラッパーです。\r
  41 \r
  42 これらとNyARToolkitは完全に分離していますので、入力・出力ともに容易に\r
  43 差し替えが出来ると思います。\r
  44 \r
  45 \r
  46 \r
  47 \r
  48 ・サンプルなど\r
  49 \r
  50 動作させる前に、JMFとJOGLをインストールしてください。\r
  51 動作確認したバージョンと入手先はこちらです。\r
  52 \r
  53 JMF JavaTM Media Framework 2.1.1e\r
  54 http://java.sun.com/products/java-media/jmf/index.jsp\r
  55 \r
  56 jogl-1.1.1-pre-20080328-windows-i586.zip\r
  57 https://jogl.dev.java.net/\r
  58 \r
  59 \r
  60 サンプルは以下のディレクトリにあります。\r
  61 \r
  62 ./src\r
  63 NyARToolkitのEclipseプロジェクトがあります。\r
  64 jp.nyatla.nyartoolkit.sampleパッケージに、Rawイメージから\r
  65 変換行列を求めるサンプルがあります。\r
  66 \r
  67 ./sample\r
  68 NyARToolkitのアプリケーションサンプルEclipseプロジェクトがあります。\r
  69 NyARJMFにはビデオキャプチャの試験プログラムと、マーカー検出プログラムがあります。\r
  70 NyARJOGLにはARToolkitのsimpleLite相当のサンプルがあります。\r
  71 \r
  72 NyARJMFのプロジェクトはNyARToolKitに依存し、NyARJOGLのプロジェクトはNyARToolKit\r
  73 とNyARJMFに依存しています。\r
  74 zipを展開すると多分参照関係が壊れてますので、再設定してください。\r
  75 \r
  76 \r
  77 \r
  78 \r
  79 ・NyARToolkitとオリジナルの差分\r
  80 \r
  81 オリジナルと演算結果に互換性がありますが、関数構成を再設計した\r
  82 ため、関数名や関数コールの手順の互換性がほとんどありません。\r
  83 \r
  84 クラスは関数機能毎にまとめた作りになっていますので、オリジナルの\r
  85 コード読んだことがあれば、なんとなく判ると思います。\r
  86 \r
  87 \r
  88 \r
  89 \r
  90 ・足りない機能等\r
  91 \r
  92 マーカーのセーブ機能と、複数マーカーの認識機能が未実装です。\r
  93 \r
  94 今後実装していきます。\r
  95 \r
  96 \r
  97 \r
  98 \r
  99 ・ライセンス\r
 100 GPLです。詳しくはLICENCE.txtをみてください。\r
 101 \r
 102 \r
 103 \r
 104 \r
 105 ・お願い\r
 106 \r
 107 NyARToolkitを使って面白いものが出来たら、是非教えてください。\r
 108 \r
 109 それと強制では有りませんが、NyARToolkitを使った感想などを\r
 110 送ってくれると、今後の励みになります。\r
 111 \r
 112 \r
 113 \r
 114 \r
 115 ではでは、楽しく遊んでくださいネ。\r
 116 \r
 117 2008.03.29 R.Iizuka@nyatla.jp\r