arcoreimg è uno strumento a riga di comando che prende un insieme di immagini di riferimento e genera
un file di database di immagini. Questo strumento è disponibile nell'SDK ARCore per Android (vedi Strumenti > arecoreimg) ed è riservato solo agli sviluppatori di Android e Android NDK.
Lo strumento consente anche di verificare la qualità delle immagini di riferimento.
Controllare la qualità dell'immagine
Una buona immagine di riferimento è difficile da individuare con l'occhio umano. Esegui arcoreimg eval-img per ottenere un punteggio di qualità compreso tra 0 e 100 per ogni immagine.
Ti consigliamo di utilizzare immagini con un punteggio di almeno 75.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
arcoreimg.exe eval-img --input_image_path=dog.png
Creare un file di database di immagini
Puoi fornire immagini di riferimento in una directory o tramite un file di elenco immagini (opzione preferita). Tieni presente che sono supportate solo le immagini PNG e JPEG e che nei nomi dei file immagine sono supportati solo i caratteri ASCII.
Crea un database di immagini da una directory di immagini
Esegui arcoreimg build-db utilizzando --input_images_directory per specificare una directory contenente le tue immagini, come mostrato di seguito:
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
A ogni immagine viene assegnato un nome predefinito in base al relativo percorso. Ad esempio, a dog.jpg
viene assegnato /path/to/images/dog.jpg come nome.
A ogni immagine viene anche assegnato un indice di numeri interi basato su 0, in base all'ordinamento ASCII dei nomi dei file delle immagini.
Si presume che tutte le immagini abbiano una larghezza fisica sconosciuta in metri.
Crea un database da un file di elenco di immagini (opzione preferita)
Il formato del file dell'elenco di immagini è mostrato di seguito:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Ogni riga contiene un nome, il percorso del file immagine e la larghezza fisica in metri dell'immagine (facoltativo).
Esegui arcoreimg build-db utilizzando --input_image_list_path per specificare un file di elenco immagini, come mostrato di seguito:
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
A ogni immagine viene assegnato un nome e un indice basato su 0 in base alla sua posizione nel file dell'elenco di immagini.
Identificazione delle immagini in fase di runtime
Utilizza AugmentedImage.getIndex()
e AugmentedImage.getName()
per identificare le immagini rilevate.