arcoreimg 工具

arcoreimg 是一个命令行工具,它可以获取一组参考图片并生成 一个图片数据库文件此工具在 ARCore SDK for Android(请参阅工具 > arecoreimg), 仅适用于 Android 和 Android NDK 开发者。

您还可以使用该工具检查参考图片的质量。

检查图片质量

肉眼很难分辨高质量的参考图像。运行 arcoreimg eval-img,获取每张图片的质量得分(介于 0100 之间)。

我们建议使用得分至少为 75 的图片。

macOS

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

Windows

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

创建图像数据库文件

您可以在目录中提供参考图片,也可以通过图片列表文件(首选)提供参考图片。 请注意,仅支持 PNG 和 JPEG 图片,且仅支持 ASCII 字符 。

从图片目录创建图片数据库

使用 --input_images_directory 运行 arcoreimg build-db,以指定 目录中,如下所示:

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

系统会根据每个图片的路径为其分配默认名称。例如:dog.jpg 分配了 /path/to/images/dog.jpg 作为其名称。

系统还会根据 ASCII 排序为每张图片分配一个从 0 开始的整数索引 图片文件名的顺序。

假定所有图像的物理宽度均未知(以米为单位)。

从图片列表文件创建数据库(首选)

图片列表文件的格式如下所示:

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

每行都包含名称图片文件路径和图片的 物理宽度(米)(可选属性)。

使用 --input_image_list_path 运行 arcoreimg build-db 来指定映像 list 文件,如下所示:

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

系统会为每个图片分配一个名称和一个基于 0 的索引,具体取决于图片 图片列表文件中的位置。

在运行时识别图片

使用AugmentedImage.getIndex()AugmentedImage.getName() 识别检测到的图像。