arcoreimg
est un outil de ligne de commande qui génère un fichier de base de données d'images à partir d'un ensemble d'images de référence. Cet outil est disponible dans le SDK ARCore pour Android (voir tools > arecoreimg). Il n'est destiné qu'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 avec l'œil humain. Exécutez arcoreimg eval-img
pour 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.
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 (méthode recommandée). 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.imgdb
Windows
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 du chemin d'accès. Par exemple, le nom dog.jpg
est /path/to/images/dog.jpg
.
Chaque image se voit également attribuer un index entier basé sur 0
, en fonction de l'ordre de tri ASCII des noms de fichiers d'image.
La largeur physique de toutes les images est considérée comme 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 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.imgdb
Windows
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 des images au moment de l'exécution
Utilisez AugmentedImage.getIndex()
et AugmentedImage.getName()
pour identifier les images détectées.