Develop and Download Open Source Software

NyARToolKit

Browse Subversion Repository

/[nyartoolkit]/nyar4psg/trunk/readme.txt

Contents of /nyar4psg/trunk/readme.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1120 - (show annotations) (download)
Tue Dec 11 14:15:54 2012 UTC (11 years, 4 months ago) by nyatla
File MIME type: text/plain
File size: 7983 byte(s) 
processing 2.0 support
1 ======================================================================
2 NyARToolkit for proce55ing
3 version 1.3.0
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 for Processing
14 ----------------------------------------------------------------------
15
16 * NyARToolkit for proce55ingは、processing環境下でNyARToolkitを利用す
17 るためのライブラリです。
18 * 拡張現実感ライブラリには、ARToolKitの派生ライブラリNyARToolKit for Java
19 を使用しています。
20 * Processing version 1.5/2.0b7での動作を確認しています。
21 * このライブラリは、processingのcamera()関数で取り込んだ画像や、PImage
22 画像を元にマーカ検出処理を実行できます。
23 * レンダリングシステムには、OPENGLとPV3Dをサポートします。
24
25
26 ----------------------------------------------------------------------
27 NyARToolkit for proce55ingの特徴
28 ----------------------------------------------------------------------
29
30 * 左手系・右手系両方の座標系をサポートします。
31 * マルチマーカ、シングルマーカののユースケースに対応します。
32 * NyIdマーカ、ARToolKitマーカの両方に対応します。
33 * 自動敷居値に対応しています。(一部のみ)
34 * パターン取得、スクリーン座標のマーカ座標変換等が手軽に使えます。
35 * レンダリングにProcessingCoreAPIのみを使います。Graphics3D派生オブジェクト
36 全てに対応します。
37
38 ----------------------------------------------------------------------
39 環境の準備
40 ----------------------------------------------------------------------
41
42 1.NyARToolkit for proce55ingの実行には、processing/1.5.1、又は2.0b以上が必要です。
43 サイトからダウンロードして下さい。
44 http://processing.org/download/index.html
45
46 2.ProcessingのCapture機能を使用できるようにコンピュータを設定してください。
47 Capture機能は、ProcessingのExamples>Libraries>Video(Capture)以下のサンプル
48 の動作で確認できます。
49 （このステップは、キャプチャ機能を使わないときには必要ありません。）
50
51
52 3.ProcessingからOpenGL機能を使用できるように、コンピュータの設定をして下さい。
53 OpenGL機能は、ProcessingのExamples>Libraries>OpenGL以下のサンプルの動作
54 で確認できます。
55 （このステップは、レンダリングにP3Dを使用するときには必要ありません。）
56
57 4.以上で準備は完了です。
58
59 ----------------------------------------------------------------------
60 サンプル実行
61 ----------------------------------------------------------------------
62 exampleにある、simpleLiteのサンプルの実行手順です。
63 simpleLiteは、Hiroマーカの上に立方体を表示するシンプルなプログラムです。
64
65 1.dataディレクトリにある、pattHiro.pdfを印刷しておいてきます。
66
67 2.libraryの中の2つのjarファイルを、example/simpleLite/codeへコピーします。
68 (Windows環境では、setup_example.batを実行することで、全てのexampleへ
69 ファイルをコピーすることができます。)
70
71 必要なファイルはProcessingのバージョン毎に異なります。
72 processing/1.x
73 jar: NyAR4psg.jar,NyARToolkit.jar
74 batch: setup_example.bat
75 processing/2.x
76 jar: NyAR4psg2b.jar,NyARToolkit.jar
77 batch: setup_example_pss2.bat
78
79 3.example/simpleLiteにある、simpleLite.pdeを開いて実行してください。
80 マーカを撮影すると、そこに立方体が表示されるはずです。
81
82 他のサンプルについても、同様の手順で試す事ができます。
83
84
85 ----------------------------------------------------------------------
86 スケッチの作り方
87 ----------------------------------------------------------------------
88 NyARToolkitを使ったスケッチには、2つのjarライブラリと、使用するマーカ
89 のパターンファイル、カメラのパラメータファイルが必要になります。
90
91 マーカファイルとカメラパターンファイルは、ARToolKitの仕様に沿ったもの
92 を用意して、スケッチのdataフォルダの中に配置します。
93
94 ライブラリは、libraryフォルダの中にある2つのファイルを、codeフォルダの
95 中に配置します。
96
97
98 ----------------------------------------------------------------------
99 NyARToolkit for Processingの提供するクラス
100 ----------------------------------------------------------------------
101
102 NyARToolkit for proce55ingは、ユースケース毎に、機能の異なる複数の
103 クラスを提供しています。
104
105 * NyARBoradクラス（NyARBoard.java）
106 1種類のARマーカを認識するクラスです。
107
108 * SingleARTKMarkerクラス（SingleARTKMarker.java）
109 複数のARマーカを登録し、そのうちの1個を認識するクラスです。
110 自動敷居値調整と、簡易トラッキング機能を備えます。
111
112 * SingleNyIdMarkerクラス（SingleNyIdMarker.java）
113 Idマーカを同時に1個認識するクラスです。
114 Idの仕様は、NyId形式です。
115
116 * MultiMarkerクラス (MultiMarker.java)
117 ARマーカ、NyIdマーカを複数個同時に扱えるクラスです。
118 このクラスを使えば、上記の3クラスは不要かもしれません。
119
120 ----------------------------------------------------------------------
121 その他
122 ----------------------------------------------------------------------
123
124 * パターンファイルやカメラパラメータファイルについて
125 NyARToolKit for Processingの使用するカメラパラメータファイル、パターン
126 ファイルは、ARToolKitと完全な互換性があります。
127 現在のライブラリには、これらを作成する機能がありません。
128 ARToolKit、またはFLARToolKitの機能を利用して作成してください。
129
130 * キャプチャライブラリについて
131 Windows環境下では、arc@dmzさん作のDirectShow Javaベースのキャプチャ
132 ライブラリCaptureDSを使用することをお勧めします。
133 このライブラリは、digitalmuseumよりダウンロードできます。
134 http://digitalmuseum.jp/software/nui/processing/
135
136
137 ----------------------------------------------------------------------
138 ライセンス
139 ----------------------------------------------------------------------
140
141 * GPLv3での提供になります。但し、src以下のファイルをのみを使用する場合
142 には、MITライセンスでも使用できます。
143 * パッケージに含まれるNyARToolkitのソースファイルは、
144 http://sourceforge.jp/projects/nyartoolkit/よりダウンロードできます。
145
146 ----------------------------------------------------------------------
147 謝辞
148 ----------------------------------------------------------------------
149
150 * ARToolKitを開発された加藤博一先生と、Human Interface Technology Lab
151 に感謝します。
152 http://www.hitl.washington.edu/artoolkit/
153
154 * Processingを開発されたCasey Reas氏と Benjamin Fry氏に感謝します。
155 http://processing.org/
156
157 * CaptureDSを開発された加藤 淳 氏に感謝します。
158 http://digitalmuseum.jp/
159
160 *Processingの座標系問題を解決して頂いた、reco氏に感謝します。
161 http://www.hyde-ysd.com/reco-memo/
162
163 *Version/1.0開発のきっかけを作って下さった、橋本 直 氏に感謝します。
Back to OSDN">Back to OSDN
 ViewVC Help
Powered by ViewVC 1.1.26  
About OSDN
Find Software
Develop Software
Help