| 1 |
====================================================================== |
| 2 |
NyARToolkitAS3 |
| 3 |
version 4.1.1 |
| 4 |
====================================================================== |
| 5 |
|
| 6 |
Copyright (C)2008-2012 Ryo Iizuka |
| 7 |
|
| 8 |
http://nyatla.jp/nyartoolkit/ |
| 9 |
airmail(at)ebony.plala.or.jp |
| 10 |
wm(at)nyatla.jp |
| 11 |
|
| 12 |
---------------------------------------------------------------------- |
| 13 |
About NyARToolkit |
| 14 |
---------------------------------------------------------------------- |
| 15 |
* NyARToolkitは、NyARToolKit 4.1.1のAPIを基盤としたARアプリケーション向けの |
| 16 |
クラスライブラリです。 |
| 17 |
* Flash10以上(Stage3Dを使う場合は11以上)に対応しています。 |
| 18 |
* ARToolKitの基本機能と、NyARToolKitオリジナルの拡張機能、フレームワーク |
| 19 |
で構成しています。 |
| 20 |
* ライブラリは4部構成です。NyARTookitを純粋に移植したsrcモジュール、NyARToolkitの |
| 21 |
RPF(Reality Platform)クラスのあるsrc.rpf,Flash向けの拡張クラスのあるsrc.flarif, |
| 22 |
サンプルのある、sampleです。 |
| 23 |
* このSDKが提供する3Dレンダラアダプタは、paperVision3Dのみです。他の3Dレンダラ |
| 24 |
アダプタに対応するときの参考にして下さい。(FLARToolKitでは対応すると思います。) |
| 25 |
* sampleモジュールは、いくつかの動作チェックプログラムと、RPFを使ったサンプルアプ |
| 26 |
リケーションがあります。 |
| 27 |
|
| 28 |
|
| 29 |
ARToolKitについては、下記のURLをご覧ください。 |
| 30 |
http://www.hitl.washington.edu/artoolkit/ |
| 31 |
|
| 32 |
---------------------------------------------------------------------- |
| 33 |
NyARToolkitAS3の特徴 |
| 34 |
---------------------------------------------------------------------- |
| 35 |
NyARToolkitAS3の特徴を紹介します。 |
| 36 |
|
| 37 |
* 入力画像、内部画像のフォーマットが、BitmapData形式です。 |
| 38 |
* 次の項目について、高速な機能が利用できます。(ラべリング、姿勢最適化、 |
| 39 |
画像処理、行列計算、方程式計算) |
| 40 |
* NyId規格のIDマーカが使用できます。 |
| 41 |
* RPF(RealityPlatform - マーカ状態管理システム)が利用できます。 |
| 42 |
* MarkerSystemが使用できます。 |
| 43 |
* 簡易スケッチシステムがあります。MarkerSystemと組み合わせることで、 |
| 44 |
以前と比較して、コンパクトな実装ができます。 |
| 45 |
|
| 46 |
|
| 47 |
---------------------------------------------------------------------- |
| 48 |
NyARToolkitAS3 License |
| 49 |
---------------------------------------------------------------------- |
| 50 |
|
| 51 |
|
| 52 |
NyARToolkitAS3は、商用ライセンスとGPLv3以降のデュアルライセンスを採用して |
| 53 |
います。 |
| 54 |
|
| 55 |
GPLv3を承諾された場合には、商用、非商用にかかわらず、無償でご利用にな |
| 56 |
れます。GPLv3を承諾できない場合には、商用ライセンスの購入をご検討くだ |
| 57 |
さい。 |
| 58 |
|
| 59 |
|
| 60 |
* GPLv3 |
| 61 |
GPLv3については、LICENCE.txtをお読みください。 |
| 62 |
|
| 63 |
* 商用ライセンス(日本国) |
| 64 |
株式会社 エム・ソフトにお問い合わせください。 |
| 65 |
http://www.msoft.co.jp/pressrelease/press090928-1.html |
| 66 |
|
| 67 |
* 商用ライセンス(その他の国) |
| 68 |
商用ライセンスについては、ARToolWorks社に管理を委託しております。 |
| 69 |
http://www.artoolworks.com/Home.html |
| 70 |
|
| 71 |
---------------------------------------------------------------------- |
| 72 |
インストール |
| 73 |
---------------------------------------------------------------------- |
| 74 |
FlashDevelopでコンパイルできるプロジェクトが、sampleフォルダにあります。 |
| 75 |
|
| 76 |
FlashDevelopはこちらからダウンロードして下さい。 |
| 77 |
http://www.flashdevelop.org/wikidocs/index.php?title=Main_Page |
| 78 |
|
| 79 |
---------------------------------------------------------------------- |
| 80 |
外部ライブラリ |
| 81 |
---------------------------------------------------------------------- |
| 82 |
NyARToolkitAS3のサンプルを動作させるには、PaperVision3d、またはAway3Dが |
| 83 |
必要です。 |
| 84 |
|
| 85 |
PaperVision3D |
| 86 |
http://blog.papervision3d.org/ |
| 87 |
|
| 88 |
Away3D |
| 89 |
http://away3d.com/ |
| 90 |
|
| 91 |
Away3Dについては、3.4以前と、4.0以降向けの2種類があります。 |
| 92 |
|
| 93 |
---------------------------------------------------------------------- |
| 94 |
サンプルの概要 |
| 95 |
---------------------------------------------------------------------- |
| 96 |
サンプルプログラムの概要です。2つのFlashDevelopプロジェクトについて、 |
| 97 |
説明します。 |
| 98 |
|
| 99 |
Sample/nytest project |
| 100 |
|
| 101 |
NyARToolkitのテストプログラムです。 |
| 102 |
|
| 103 |
* Main.as |
| 104 |
NyARToolkitのテストプログラムです。 |
| 105 |
ベンチマークと、基本クラスのテストを実行して、結果を表示します。 |
| 106 |
依存する外部ライブラリはありません。 |
| 107 |
|
| 108 |
Sample/FLTest project |
| 109 |
|
| 110 |
FLARToolkitのテストプログラムです。 |
| 111 |
|
| 112 |
* Main.as |
| 113 |
NyARToolkitのFlash拡張部分のテストと、ベンチマークプログラムです。 |
| 114 |
テスト結果をコンソールに出力します。 |
| 115 |
依存する外部ライブラリはありません。 |
| 116 |
|
| 117 |
* ARTKView.as |
| 118 |
RPFを使った、ARToolKitマーカの出力プログラムです。マーカには、Hiroマーカ |
| 119 |
を使ってください。 |
| 120 |
|
| 121 |
* NyIdView.as |
| 122 |
RPFを使った、NyIdマーカの出力プログラムです。Idマーカを使ってください。 |
| 123 |
|
| 124 |
Sample/Pv3d |
| 125 |
paperVision3dを使ったサンプルプログラムです。sketchのサンプルのみとなります。 |
| 126 |
|
| 127 |
*IdMarker.as |
| 128 |
IDマーカを認識するプログラムです。ID0のマーカを使ってください。 |
| 129 |
*ImagePickup.as |
| 130 |
マーカ平面から画像を取得するプログラムです。Hiroマーカを使ってください。 |
| 131 |
*JpegInput.as |
| 132 |
カメラ画像の変わりにJpeg画像を入力するプログラムです。 |
| 133 |
*MarkerPlane.as |
| 134 |
マーカ平面とマウス座標の相互変換をするプログラムです。 |
| 135 |
*PngMarker.as |
| 136 |
マーカパターンにPNG画像を使うプログラムです。 |
| 137 |
*SimpleLite.as |
| 138 |
ARマーカに立方体を表示するプログラムです。Hiroマーカを使ってください。 |
| 139 |
*SimpleLiteM.as |
| 140 |
複数のARマーカに立方体を表示するプログラムです。HiroマーカとKanjiマーカを |
| 141 |
使ってください。 |
| 142 |
|
| 143 |
Sample/Away3d |
| 144 |
Away3D version 3.4以前向けのサンプルです。スクリーン制御に難があるため、640x480 |
| 145 |
以外のサイズではうまく動きません。 |
| 146 |
|
| 147 |
Sample/Away3D4 |
| 148 |
Away3D version 4.0.0 beta向けのデモです。 |
| 149 |
|
| 150 |
|
| 151 |
---------------------------------------------------------------------- |
| 152 |
既知の不具合 |
| 153 |
---------------------------------------------------------------------- |
| 154 |
1.RPFの姿勢フィードバックが未実装。 |
| 155 |
2.RPFの輪郭線抽出系のノイズ処理が最小二乗法の為、遅延が大きい。 |
| 156 |
3.RPFの輪郭線抽出系のアルゴリズム不備で輪郭線のドリフトが発生し、トラッキング |
| 157 |
性能が低下する。 |
| 158 |
4.RPFの二次元系追跡機能の性能が低い。 |
| 159 |
5.RPFのエッジ抽出が、ブラーに弱い。 |
| 160 |
6.RPFの初期検出性能が、旧NyARToolkit系と比較して、低い。 |
| 161 |
|
| 162 |
---------------------------------------------------------------------- |
| 163 |
Special thanks |
| 164 |
---------------------------------------------------------------------- |
| 165 |
加藤博一先生 (Hirokazu Kato, Ph. D.) |
| 166 |
http://www.hitl.washington.edu/artoolkit/ |
| 167 |
|
| 168 |
Prof. Mark Billinghurst |
| 169 |
http://www.hitlabnz.org/ |
| 170 |
|
| 171 |
Saqooshaさん |
| 172 |
http://saqoo.sh/a/ |