arcoreimg 工具

arcoreimg 是一个命令行工具，用于获取一组参考图片并生成图片数据库文件。此工具在 适用于 Android 的 ARCore SDK 中提供（请参阅 tools > arecoreimg），仅适用于 Android 和 Android NDK 开发者。

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

检查图片质量

好的参考图片在人眼中很难发现瑕疵。运行 arcoreimg eval-img 可为每张图片获取介于 0 到 100 之间的画质得分。

我们建议使用至少 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 以指定图片列表文件，如下所示：

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() 来识别检测到的图片。