Lo strumento arcoreimg

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 in SDK ARCore per Android (vedi strumenti > arecoreimg), ed è riservato esclusivamente agli sviluppatori Android e Android NDK.

Lo strumento ti consente anche di verificare la qualità delle immagini di riferimento.

Controlla 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

Crea un file di database di immagini

Puoi fornire immagini di riferimento in una directory o tramite un file elenco immagini (opzione preferita). Tieni presente che sono supportate solo immagini PNG e JPEG e solo caratteri ASCII. supportati nei nomi file immagine.

Crea un database di immagini da una directory di immagini

Esegui arcoreimg build-db utilizzando --input_images_directory per specificare un che contiene 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, dog.jpg ha il nome /path/to/images/dog.jpg.

A ogni immagine viene anche assegnato un indice intero basato su 0, basato sull'ordinamento ASCII nell'ordine dei nomi file dell'immagine.

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 è il seguente:

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

Ogni riga contiene un nome, il percorso del file di immagine e il larghezza fisica in metri (facoltativo).

Esegui arcoreimg build-db utilizzando --input_image_list_path per specificare un'immagine 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 al relativo posizione nel file di elenco di immagini.

Identificazione delle immagini in fase di esecuzione

Utilizza AugmentedImage.getIndex() e AugmentedImage.getName() per identificare le immagini rilevate.