A ferramenta arcoreimg

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 SDK do ARCore para Android (consulte Ferramentas > arecoreimg), e é destinada apenas a desenvolvedores do Android e do Android NDK.

Essa ferramenta também permite verificar a qualidade das suas imagens de referência.

Verificar a qualidade das imagens

Uma boa imagem de referência é difícil de detectar com o olho humano. Execute arcoreimg eval-img para receber 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 por meio de um arquivo de lista de imagens (preferencial). Somente imagens PNG e JPEG são compatíveis, e apenas caracteres ASCII suportado nos nomes de arquivo das imagens.

Criar um banco de dados de imagens usando um diretório de imagens

Execute arcoreimg build-db usando --input_images_directory para especificar um que contém as 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. Por exemplo, dog.jpg. recebe o nome /path/to/images/dog.jpg como nome.

Cada imagem também recebe um índice inteiro baseado em 0, de acordo com a classificação ASCII ordem dos nomes dos arquivos das imagens.

Todas as imagens serão consideradas com uma largura física desconhecida em metros.

Criar um banco de dados a partir de um arquivo de lista de imagens (Preferencial)

O formato do arquivo da lista de imagens é mostrado abaixo:

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 o largura física em metros (opcional).

Execute arcoreimg build-db usando --input_image_list_path para especificar uma imagem. , como 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 o no arquivo da lista de imagens.

Como identificar imagens no momento da execução

Usar AugmentedImage.getIndex() e AugmentedImage.getName() para identificar imagens detectadas.