Alat arcoreimg

arcoreimg adalah alat command line yang mengambil kumpulan gambar referensi dan menghasilkan file database gambar. Alat ini tersedia di ARCore SDK untuk Android (lihat tools > arecoreimg), dan hanya ditujukan untuk developer Android dan Android NDK.

Alat ini juga memungkinkan Anda memeriksa kualitas gambar referensi.

Memeriksa kualitas gambar

Gambar referensi yang baik sulit dilihat dengan mata manusia. Jalankan arcoreimg eval-img untuk mendapatkan skor kualitas antara 0 dan 100 untuk setiap gambar.

Sebaiknya gunakan gambar dengan skor minimal 75.

macOS

./arcoreimg eval-img --input_image_path=dog.jpg

Windows

arcoreimg.exe eval-img --input_image_path=dog.png

Membuat file database gambar

Anda dapat menyediakan gambar referensi dalam direktori atau melalui file daftar gambar (lebih disarankan). Perhatikan bahwa hanya gambar PNG dan JPEG yang didukung, dan hanya karakter ASCII yang didukung dalam nama file gambar.

Membuat database gambar dari direktori gambar

Jalankan arcoreimg build-db menggunakan --input_images_directory untuk menentukan direktori yang berisi gambar Anda seperti yang ditunjukkan di bawah:

macOS

./arcoreimg build-db --input_images_directory=/path/to/images \
                       --output_db_path=/path/to/myimages.imgdb

Windows

arcoreimg.exe build-db --input_images_directory=/path/to/images --output_db_path=/path/to/myimages.imgdb

Setiap gambar diberi nama default berdasarkan jalurnya. Misalnya, dog.jpg diberi nama /path/to/images/dog.jpg.

Setiap gambar juga diberi indeks bilangan bulat berbasis 0, berdasarkan urutan pengurutan ASCII nama file gambar.

Semua gambar akan diasumsikan memiliki lebar fisik yang tidak diketahui dalam meter.

Membuat database dari file daftar gambar (Direkomendasikan)

Format file daftar gambar ditampilkan di bawah ini:

mouse|path/to/mouse.png|0.1
little dog|/path/to/dog.jpg

Setiap baris berisi nama, jalur file gambar, dan lebar fisik gambar dalam meter (opsional).

Jalankan arcoreimg build-db menggunakan --input_image_list_path untuk menentukan file daftar gambar seperti yang ditunjukkan di bawah:

macOS

./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
                       --output_db_path=/path/to/myimages.imgdb

Windows

arcoreimg.exe build-db --input_image_list_path=/path/to/image_list_file.txt --output_db_path=/path/to/myimages.imgdb

Setiap gambar diberi nama dan indeks berbasis 0 berdasarkan posisinya dalam file daftar gambar.

Mengidentifikasi gambar saat runtime

Gunakan AugmentedImage.getIndex() dan AugmentedImage.getName() untuk mengidentifikasi gambar yang terdeteksi.