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 le SDK ARCore pour Android (voir tools > arecoreimg) et est réservé aux développeurs Android et Android NDK.
L'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 pour obtenir un score de qualité compris entre 0 et 100 pour chaque image.
Nous vous recommandons d'utiliser des images avec un score d'au moins 75.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
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 (recommandé). Notez que seules les images PNG et JPEG sont acceptées, et que seuls les caractères ASCII sont acceptés 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 un répertoire contenant vos images, comme indiqué ci-dessous:
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
Un nom par défaut est attribué à chaque image en fonction de son chemin d'accès. Par exemple, dog.jpg est attribué le nom /path/to/images/dog.jpg.
Chaque image se voit également attribuer un indice entier basé sur 0, en fonction de l'ordre de tri ASCII des noms de fichiers d'image.
On supposera que la largeur physique des images est 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 présenté 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 la largeur physique de l'image en mètres (facultatif).
Exécutez arcoreimg build-db à l'aide de --input_image_list_path pour spécifier un fichier de liste d'images, comme indiqué ci-dessous:
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
Chaque image se voit attribuer un nom et un index basé sur 0 en fonction de sa position dans le fichier de liste d'images.
Identifier les images au moment de l'exécution
Utilisez AugmentedImage.getIndex() et AugmentedImage.getName() pour identifier les images détectées.