arcoreimg é uma ferramenta de linha de comando que usa um conjunto de imagens de referência e gera um arquivo de banco de dados de imagens. Essa ferramenta está disponível no
SDK do ARCore para Android (consulte tools > arecoreimg)
e é destinada apenas a desenvolvedores do Android e do Android NDK.
A ferramenta também permite verificar a qualidade das imagens de referência.
Verificar a qualidade das imagens
Uma boa imagem de referência é difícil de identificar com o olho humano. Execute arcoreimg eval-img para ter um índice de qualidade entre 0 e 100 para cada imagem.
Recomendamos usar imagens com uma pontuação de pelo menos 75.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
arcoreimg.exe eval-img --input_image_path=dog.png
Criar um arquivo de banco de dados de imagens
É possível fornecer imagens de referência em um diretório ou em um arquivo de lista de imagens (preferencial). Somente imagens PNG e JPEG são aceitas, e apenas caracteres ASCII são compatíveis em nomes de arquivos de imagem.
Criar um banco de dados de imagens com base em um diretório de imagens
Execute arcoreimg build-db usando --input_images_directory para especificar um
diretório que contém suas imagens, conforme mostrado abaixo:
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
Cada imagem recebe um nome padrão com base no caminho correspondente. Por exemplo, o nome dog.jpg
é atribuído a /path/to/images/dog.jpg.
Cada imagem também recebe um índice inteiro baseado em 0, com base na ordem de classificação ASCII
dos nomes dos arquivos das imagens.
Será considerado que todas as imagens têm uma largura física desconhecida em metros.
Criar um banco de dados usando um arquivo de lista de imagens (preferencial)
Confira abaixo o formato do arquivo da lista de imagens:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Cada linha contém um nome, o caminho do arquivo de imagem e a largura física em metros da imagem (opcional).
Execute arcoreimg build-db usando --input_image_list_path para especificar um arquivo
de lista de imagens, conforme mostrado abaixo:
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
Cada imagem recebe um nome e um índice baseado em 0, de acordo com a posição no arquivo da lista de imagens.
Como identificar imagens no momento da execução
Use AugmentedImage.getIndex()
e AugmentedImage.getName()
para identificar imagens detectadas.