Instalasi ARToolKit

Pada artikel kali ini, kita akan melakukan instalasi ARToolkit pada sistem operasi Windows XP (untuk pengguna Windows Vista atau Seven, saya tidak bisa memberikan jaminan bahwa tutorial ini akan berhasil dengan baik). Sebagai catatan, artikel instalasi ARToolkit ini sedikit banyak saya ambil dari sebuah buku ARToolkit berbahasa Jepang, berjudul: ARToolKit拡張現実感プログラミング入門 (Introduction to Augmented Reality Programming with ARToolkit) dengan website resmi yang bisa Anda akses di link ini (jika Anda membutuhkan source code program untuk latihan, Anda bisa juga mendownload file ISO yang berisi program-program latihan dari buku ini).

Nah, tanpa banyak kata, kita mulai saja proses instalasinya. 一緒にはじめましょ…(Bersama-sama, mari kita mulai!)

1. Kebutuhan Hardware

• Komputer dengan spesifikasi minimal RAM minimal 512 MHz dan VGA minimal 128MB
• Webcamera QuickCam Logitech berikut driver-nya. Untuk mendapatkan frame rate yang tinggi, saya sarankan Anda menggunakan kamera Logitech QuickCam Pro 9000 (Anda bisa mendapatkan frame rate sampai dengan 60 Hertz)
• Marker atau patterns (sudah tersedia di dalam instalasi ARToolkit).
• Printer, dibutuhkan untuk mencetak marker yang ada di dalam file instalasi ARToolkit. Adapun pattern yang akan kita pakai pada instalasi kita adalah pattHiro.pdf (lihat gambar di bawah ini):

2. Kebutuhan Software (plus additional DLL)

• Paket ARToolKit, bisa diperoleh di sini: http://sourceforge.net/projects/artoolkit/files/
  Percobaan ini menggunakan ARToolKit versi 2.7.2.1
• Sistem operasi Windows XP (sampai saat ini kompatibilitas Windows Vista dan Seven belum teruji)
• OpenGL library dan GLUT. Untuk OpenGL, sudah terinstalasi bersama sistem operasi Windows XP. Untuk GLUT, silahkan download versi 3.7.6 di sini:
  http://www.xmission.com/~nate/glut.html
• DSVideoLib-0.0.8b-win32, bisa didownload di halaman yang sama dengan paket ARToolKit.
• DirectX Runtime minimal versio 9.0b.
• OpenVRML-0.14.3-win32, bisa didownload di halaman yang sama dengan paket ARToolKit
• File library DLL tambahan: msvcp71d.dll dan msvcr71d.dll. Bisa di-download di sini: additional_dll.zip
• Development environment, menggunakan Microsoft Visual Studio 2005 atau Visual Studio 2008. Dalam percobaan ini kami menggunakan Visual Studio 2005.

3. Langkah-langkah instalasi

a. Unzip file GLUT yang sudah Anda download. Instalasi GLUT dilakukan dengan mengopikan file-file di bawah ini:

• Kopikan file glut32.dll ke C:\Windows\System32
• Kopikan file glut.h di C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\Include\gl
• Kopikan file glut32.lib ke C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\Lib

b. Kopikan file DLL tambahan msvcp71d.dll dan msvcr71d.dll ke C:\Windows\System32

c. Unzip file ARToolKit dan kopikan ke dalam C:\Program Files\, sehingga folder root Anda akan memiliki path sebagai berikut C:\Program Files\ARToolKit. Untuk selanjutnya, path ini akan disingkah sebagai {artoolkit} saja.

d. Unzip file DSVideoLib, pastikan semua file berada di dalam folder bernama “DSVL”. Kemudian kopikan folder “DSVL” tersebut ke dalam folder {artoolkit}.

e. Kopikan file DSVL.dll dan DSVLd.dll dari {artoolkit}\DSVL\bin ke dalam {artoolkit}\bin

f. Unzip file OpenVRML dan kopikan folder OpenVRML ke dalam {artoolkit}

g. Kopikan file js32.dll dari {artoolkit}\OpenVRML\bin ke dalam {artoolkit}\bin

h. Buka command prompt dengan memencet tombol Start >> Run, kemudian mengisikan perintah “cmd”.

i. Jalankan script {artoolkit}\Configure.win32.bat untuk membuat file {artoolkit}\include\AR\config.h sebagaimana gambar di bawah ini:

j. Terakhir, buka folder C:\Program Files\ARToolKit\bin dan kopikan semua file *.dll dalam folder tersebut ke C:\Windows\System32

Untuk mendapatkan kecepatan capture yang cukup baik, tingkatkan frame rate kamera menjadi 30 Hz. Kemudian cobalah dua buah program, simpleLite.exe dan simpleVRML.exe. Jangan lupa gunakan marker/pattern yang sudah Anda cetak dan hadapkan ke webcam Anda.

a. SimpleLite : C:\Program Files\ARToolKit\bin\simpleLite.exe

b. SimpleVRML: C:\Program Files\ARToolKit\bin\simpleVRML.exe

5. Membangun project AR di Visual Studio 2005

Nah, Sahabat DIP.Warrior, jika pada tutorial sebelumnya kita sudah mencoba beberapa program ARToolkit, langkah-langkah di bawah akan menjelaskan secara bertahap .
a. Buatlah project baru dengan nama simple. Pilih “Create directory for solution” untuk memastikan project yang dibuat disimpan dalam direktori yang sesuai dengan nama project tersebut. Perhatikan gambar di bawah ini.

b. Untuk project kali ini, kita akan membuat sebuah Console application. Pilih “Empty project” untuk membuat project kosong tanpa Predefined header. Untuk lebih jelasnya, perhatikan gambar di bawah ini.

c. Untuk mengonfigurasi Visual Studio 2005, kita perlu menambahkan beberapa parameter. Pilih “Tools” >> “Options”.

d. Pada bagian “Project and Solutions”, pilih “VC++ Directories”. Kemudian, pada menu “Show directories for:” di bagian kanan, pilih “Include files”.

e. Isikan path di bawah ini:

C:\Program Files\ARToolKit\include
C:\Program Files\ARToolKit\OpenVRML\include
C:\Program Files\ARToolKit\OpenVRML\dependencies\include

f. Setelah langkah (g) selesai dilakukan, pilih kembali menu “Show directories for:” pada bagian kanan atas. Pilih “Library files”. Masukkan path di bawah ini:

C:\Program Files\ARToolKit\lib
C:\Program Files\ARToolKit\OpenVRML\lib
C:\Program Files\ARToolKit\OpenVRML\dependencies\lib

g. Pada bagian Solution Explorer, klik kanan folder “Source Files”. Tambahkan file baru dengan memilih menu “Add” >> “New Item”

h. Buatlah sebuah file C++ dengan nama “simple.cpp”. Bukalah file simpleLite.c dalam folder {artoolkit}\examples\simpleLite, kemudian kopikan isi file tersebut ke file “simple.cpp” yang telah Anda buat.

i. Buka properties dari file project Anda dengan memilih menu “Project” >> “simple Properties” sebagaimana gambar di bawah ini.

j. Pada menu bagian kiri, pilih “Configuration Properties” >> “Linker” >> “Input”. Kemudian lihat menu isian di bagian kanan. Piliah “Additional Dependencies”.

k. Isikan nama library di bawah ini, lengkap dengan tanda (“ ”) di bagian isian “Additional Dependencies”:

“libARd.lib”
“libARgsubd.lib”
“libARgsub_lited.lib”
“libARgsubUtild.lib”
“libARMultid.lib”
“libARvideod.lib”
“libARvrmld.lib”
“openvrml.lib”
“openvrmlgl.lib”
“antlr.lib”
“regex.lib”
“libjpeg.lib”
“libpng.lib”
“zlib.lib”
“ws2_32.lib”
“opengl32.lib”
“glu32.lib”
“glut32.lib”

l. Kopi folder “Data” dari {artoolkit}\bin ke dalam direktori project Anda: C:\Documents and Settings\<userAnda>\My Documents\Visual Studio 2005\Projects\simple\simple

m. Pilih menu “Debug” >> “Start Debugging” untuk menjalankan aplikasi dan men-debug kesalahan yang muncul

[Catatan 1]

Pada langkah “l”, Anda harus mengopikan folder “Data” dari {artoolkit}/bin ke dalam direktori project Anda. Ada cara lain yang bisa Anda lakukan, tanpa harus mengopikan folder “Data” ke dalam setiap folder project Anda, sebagai berikut:

a. Masukkan path folder {artoolkit}/bin ke dalam environment variables Windows XP. Caranya, klik menu “Start”, kemudian pada ikon “My Computer”, klik kanan mouse Anda. Pilih “Properties” >> “Advanced” . Klik tombol [Environment Variables]. Pilih bagian “Path” dan klik tombol [Edit].

b. Pada bagian “path”, tambahkan (;) kemudian isikan path berikut ini: C:\Program Files\ARToolKit\bin. Setelah itu klik [OK].

c. Restart komputer Anda.

d. Amati nama webcam yang terdeteksi di komputer Anda. Pada komputer yang saya gunakan, webcam terdeteksi dengan nama “Logitech QuickCam Easy/Cool”.

e. Buka folder “Data” di {artoolkit}/bin, kemudian edit file “WDM_camera_flipV.xml”. Sesuaikan nama user pada path “Document and Settings” dan ubah “Friendly Name” sesuai dengan nama webcam yang terdeteksi di komputer Anda. Pada komputer saya, nama webcam yang terdeteksi adalah “Logitech QuickCam Easy/Cool”

f. Pada Project Anda, buka properties, kemudian pilih “Debugging” di menu bagian kiri. Masukkan working directory Anda sebagai berikut: C:\Program Files\ARToolKit\bin
Kemudian tekan [Apply] dan [OK]

[Catatan 2]

Untuk pilihan “Release”, Anda harus mengganti beberapa “Additional Dependencies” sebagaimana dijelaskan langkah “k”. Beberapa library yang harus diganti antara lain:

NB:
* Jika Anda membutuhkan file PDF tutorial di atas, silahkan download di link ini: instalasi ARToolKit
* Tutorial ini hanya ditujukan untuk kepentingan penelitian belaka. Jika Anda akan mencantumkannya untuk tujuan komersial (dalam pembuatan buku, makalah berbayar atau paper untuk jurnal maupun konferensi, atau perangkat lunak komersial berbasis ARToolkit), dimohon menghubungi penulis untuk copyright agreement.

Regards,

- Sunu Wibirama -

1 Comments

1. Martinus says:

   April 28, 2011 at 8:08 pm

   Salam kenal Mas Sunu Wibirama,

   Pertama2 saya ingin mengucapkan terima kasih banyak karena telah membuat tutorial yang sangat mudah dimengerti.

   Nama saya Martinus dan saya telah mencoba membuild dan merun program SimpleLite.c ini sesuai tutorial di atasd an berhasil. Akan tetapi, ada beberapa pertanyaan di benak saya, yaitu :

   1. Apakah bisa digunakan teknik kalibrasi camera cvCalibrateCamera2 dengan menggunakan library OpenCV dan menyimpan hasilnya dalam bentuk “camera_para.dat”? Karena saya rasa setiap camera dengan lensa yang berbeda akan memiliki intrinsic dan distortion parameter yang berbeda – beda. (Mohon diberikan juga beberapa tutorial untuk hal ini)

   2. Apakah bisa dengan ARToolKit ini kita mendeteksi banyak marker (10 – 20) dengan ID yang berbeda dan posisi yang tidak planar?

   Terima kasih banyak atas perhatian dan bantuannya.

   Best regards,

   Martinus

   Reply

Post a Comment

Click here to cancel reply.

Name (required) E-Mail (required) Website

 

Security Code: