Инструмент arcoreimg

arcoreimg — это инструмент командной строки, который принимает набор эталонных изображений и генерирует файл базы данных изображений. Этот инструмент доступен в ARCore SDK для Android (см. инструменты > arecoreimg ) и предназначен только для разработчиков Android и Android NDK.

Инструмент также позволяет вам проверять качество эталонных изображений.

Проверьте качество изображения

Хорошее эталонное изображение трудно обнаружить человеческим глазом. Запустите arcoreimg eval-img , чтобы получить оценку качества от 0 до 100 для каждого изображения.

Мы рекомендуем использовать изображения с оценкой не ниже 75 .

macOS

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

Окна

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

Создайте файл базы данных изображений

Вы можете предоставить эталонные изображения в каталоге или через файл списка изображений (предпочтительно). Обратите внимание, что поддерживаются только изображения PNG и JPEG, а в именах файлов изображений поддерживаются только символы ASCII.

Создать базу данных изображений из каталога изображений

Запустите arcoreimg build-db , используя --input_images_directory , чтобы указать каталог, содержащий ваши изображения, как показано ниже:

macOS

./arcoreimg build-db --input_images_directory=/path/to/images \
                       --output_db_path=/path/to/myimages.imgdb

Окна

arcoreimg.exe build-db --input_images_directory=/path/to/images --output_db_path=/path/to/myimages.imgdb

Каждому изображению присваивается имя по умолчанию в зависимости от его пути. Например, для dog.jpg в качестве имени назначается /path/to/images/dog.jpg .

Каждому изображению также присваивается целочисленный индекс с отсчетом 0 , основанный на порядке сортировки ASCII имен файлов изображений.

Предполагается, что все изображения имеют неизвестную физическую ширину в метрах.

Создать базу данных из файла списка изображений (предпочтительно)

Формат файла списка изображений показан ниже:

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

Каждая строка содержит имя , путь к файлу изображения и физическую ширину изображения в метрах (необязательно).

Запустите arcoreimg build-db используя --input_image_list_path , чтобы указать файл списка изображений, как показано ниже:

macOS

./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
                       --output_db_path=/path/to/myimages.imgdb

Окна

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() для идентификации обнаруженных изображений.