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 tools > arecoreimg) ed è destinato solo agli sviluppatori Android e Android NDK.
Lo strumento ti consente anche di controllare la qualità delle immagini di riferimento.
Controlla la qualità dell'immagine
Un'immagine di riferimento di buona qualità è 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.
./arcoreimg eval-img --input_image_path=dog.jpg
arcoreimg.exe eval-img --input_image_path=dog.png
Creare un file di database di immagini
Puoi fornire le immagini di riferimento in una directory o tramite un file elenco di immagini (opzione preferita). Tieni presente che sono supportate solo le immagini PNG e JPEG e solo i caratteri ASCII nei nomi file delle immagini.
Creare un database di immagini da una directory di immagini
Esegui arcoreimg build-db utilizzando --input_images_directory per specificare una directory contenente le immagini, come mostrato di seguito:
./arcoreimg build-db --input_images_directory=/path/to/images \ --output_db_path=/path/to/myimages.imgdb
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 il nome /path/to/images/dog.jpg.
A ogni immagine viene inoltre assegnato un indice intero basato su 0, in base all'ordine di ordinamento ASCII dei nomi file delle immagini.
Per tutte le immagini si presumerà una larghezza fisica sconosciuta in metri.
Creare un database da un file elenco di immagini (opzione preferita)
Di seguito è riportato il formato del file dell'elenco di immagini:
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 di immagini come mostrato di seguito:
./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \ --output_db_path=/path/to/myimages.imgdb
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.