arcoreimg
是一个命令行工具,用于获取一组参考图片并生成图片数据库文件。此工具在 ARCore SDK for Android 中提供(请参阅工具 > 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()
识别检测到的图片。