Outil arcoreimg

arcoreimg est un outil de ligne de commande qui prend un ensemble d'images de référence et génère un fichier de base de données d'images. Cet outil est disponible dans SDK ARCore pour Android (voir tools > arecoreimg) Il est réservé aux développeurs Android et NDK Android.

Cet outil vous permet également de vérifier la qualité de vos images de référence.

Vérifier la qualité de l'image

Une bonne image de référence est difficile à repérer à l'œil humain. Exécutez arcoreimg eval-img afin d'obtenir un niveau de qualité compris entre 0 et 100 pour chaque image.

Nous vous recommandons d'utiliser des images avec un score d'au moins 75.

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

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

Créer un fichier de base de données d'images

Vous pouvez fournir des images de référence dans un répertoire ou via un fichier de liste d'images (méthode recommandée). Seules les images PNG et JPEG sont acceptées, et seuls les caractères ASCII sont acceptés. pris en charge dans les noms de fichiers d'image.

Créer une base de données d'images à partir d'un répertoire d'images

Exécutez arcoreimg build-db à l'aide de --input_images_directory pour spécifier une contenant vos images, comme indiqué ci-dessous:

./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

Chaque image se voit attribuer un nom par défaut en fonction de son chemin d'accès. Exemple : dog.jpg porte le nom /path/to/images/dog.jpg.

Chaque image se voit également attribuer un index entier basé sur 0, basé sur le tri ASCII l'ordre des noms de fichiers image.

Toutes les images sont censées avoir une largeur physique inconnue en mètres.

Créer une base de données à partir d'un fichier de liste d'images (recommandé)

Le format du fichier de liste d'images est indiqué ci-dessous:

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

Chaque ligne contient un nom, le chemin d'accès au fichier image et le numéro physique en mètres (facultatif).

Exécutez arcoreimg build-db avec --input_image_list_path pour spécifier une image. list, comme indiqué ci-dessous:

./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

Chaque image se voit attribuer un nom et un index basé sur 0 en fonction de son dans le fichier de liste d'images.

Identifier les images au moment de l'exécution

Utiliser AugmentedImage.getIndex() et AugmentedImage.getName() pour identifier les images détectées.