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.
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). 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:
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 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:
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 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.