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

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

Verificar a qualidade da imagem

Uma boa imagem de referência é difícil de detectar pelo 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 em um arquivo de lista de imagens (preferível). Apenas imagens PNG e JPEG são aceitas, e apenas caracteres ASCII são aceites em nomes de arquivos de imagem.

Criar um banco de dados de imagens a partir de um diretório de imagens

Execute arcoreimg build-db usando --input_images_directory para especificar um diretório que contenha 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 dela. Por exemplo, dog.jpg recebe /path/to/images/dog.jpg como nome.

Cada imagem também recebe um índice de número inteiro baseado em 0, com base na ordem de classificação ASCII dos nomes de arquivo de imagem.

Todas as imagens terão uma largura física desconhecida em metros.

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

O formato do arquivo de 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 a largura física da imagem em metros (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 com base na posição no arquivo de lista de imagens.

Como identificar imagens no ambiente de execução

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