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