arcoreimg
es una herramienta de línea de comandos que toma un conjunto de imágenes de referencia y genera un archivo de base de datos de imágenes. Esta herramienta está disponible en el SDK de ARCore para Android (consulta tools > arecoreimg) y solo es para desarrolladores de Android y Android NDK.
La herramienta también te permite verificar la calidad de tus imágenes de referencia.
Verifica la calidad de la imagen
Una buena imagen de referencia es difícil de detectar con el ojo humano. Ejecuta arcoreimg eval-img
para obtener una puntuación de calidad entre 0 y 100 para cada imagen.
Recomendamos usar imágenes con una puntuación de al menos 75.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
arcoreimg.exe eval-img --input_image_path=dog.png
Crea un archivo de base de datos de imágenes
Puedes proporcionar imágenes de referencia en un directorio o a través de un archivo de lista de imágenes (opción preferida). Ten en cuenta que solo se admiten imágenes PNG y JPEG, y solo se admiten caracteres ASCII en los nombres de archivo de las imágenes.
Crea una base de datos de imágenes a partir de un directorio de imágenes
Ejecuta arcoreimg build-db
con --input_images_directory
para especificar un directorio que contenga tus imágenes, como se muestra a continuación:
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
A cada imagen se le asigna un nombre predeterminado según su ruta de acceso. Por ejemplo, a dog.jpg
se le asigna /path/to/images/dog.jpg
como nombre.
A cada imagen también se le asigna un índice de número entero basado en 0
, según el orden de clasificación ASCII de los nombres de archivo de imagen.
Se supondrá que todas las imágenes tienen un ancho físico desconocido en metros.
Crea una base de datos a partir de un archivo de lista de imágenes (opción preferida)
A continuación, se muestra el formato del archivo de lista de imágenes:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Cada línea contiene un nombre, la ruta de acceso del archivo de imagen y el ancho físico en metros de la imagen (opcional).
Ejecuta arcoreimg build-db
con --input_image_list_path
para especificar un archivo de lista de imágenes como se muestra a continuación:
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
A cada imagen se le asigna un nombre y un índice basado en 0
según su posición en el archivo de lista de imágenes.
Cómo identificar imágenes durante el tiempo de ejecución
Usa AugmentedImage.getIndex()
y AugmentedImage.getName()
para identificar las imágenes detectadas.