arcoreimg, bir referans resim grubunu alıp görüntü veritabanı dosyası oluşturan bir komut satırı aracıdır. Bu araç, Android için ARCore SDK'sında (tools > arecoreimg bölümüne bakın) bulunur ve yalnızca Android ve Android NDK geliştiricileri içindir.
Bu araç, referans resimlerinizin kalitesini de kontrol etmenizi sağlar.
Resim kalitesini kontrol etme
İyi bir referans resmini insan gözüyle tespit etmek zordur. Her resim için 0 ile 100 arasında bir kalite puanı almak üzere arcoreimg eval-img komutunu çalıştırın.
En az 75 puan alan resimleri kullanmanızı öneririz.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
arcoreimg.exe eval-img --input_image_path=dog.png
Resim veritabanı dosyası oluşturma
Referans resimleri bir dizinde veya resim listesi dosyası (tercih edilir) aracılığıyla sağlayabilirsiniz. Yalnızca PNG ve JPEG resimlerin ve resim dosya adlarında yalnızca ASCII karakterlerin desteklendiğini unutmayın.
Resim dizininden resim veritabanı oluşturma
Aşağıda gösterildiği gibi resimlerinizi içeren bir dizin belirtmek için --input_images_directory kullanarak arcoreimg build-db'ü çalıştırın:
macOS
./arcoreimg build-db --input_images_directory=/path/to/images \
--output_db_path=/path/to/myimages.imgdbWindows
arcoreimg.exe build-db --input_images_directory=/path/to/images --output_db_path=/path/to/myimages.imgdb
Her resme, yoluna göre varsayılan bir ad atanır. Örneğin, dog.jpg adlı öğeye /path/to/images/dog.jpg adı atanır.
Her resme, resim dosya adlarının ASCII sıralama sırasına göre 0 tabanlı bir tam sayı dizini de atanır.
Tüm resimlerin metre cinsinden fiziksel genişliğinin bilinmediği varsayılır.
Görüntü listesi dosyasından veritabanı oluşturma (Tercih edilen)
Resim listesi dosyasının biçimi aşağıda gösterilmiştir:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Her satırda bir ad, resim dosyası yolu ve resmin metre cinsinden fiziksel genişliği (isteğe bağlı) bulunur.
Aşağıda gösterildiği gibi bir resim listesi dosyası belirtmek için --input_image_list_path kullanarak arcoreimg build-db'ü çalıştırın:
macOS
./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
--output_db_path=/path/to/myimages.imgdbWindows
arcoreimg.exe build-db --input_image_list_path=/path/to/image_list_file.txt --output_db_path=/path/to/myimages.imgdb
Her resme, resim listesi dosyasındaki konumuna göre bir ad ve 0 tabanlı bir dizin atanır.
Çalışma zamanında resimleri tanımlama
Tespit edilen resimleri tanımlamak için AugmentedImage.getIndex() ve AugmentedImage.getName() öğelerini kullanın.