Develop and Download Open Source Software

NyARToolKit

Browse Subversion Repository

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

Annotation of /nyar4psg/trunk/readme.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 823 - (hide annotations) (download)
Fri Apr 22 18:04:53 2011 UTC (12 years, 11 months ago) by nyatla
File MIME type: text/plain
File size: 7758 byte(s) 
nyar4psg

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