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 es solo para desarrolladores del NDK de Android y Android.
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 un nivel 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 mediante un archivo de lista de imágenes (opción preferida). Ten en cuenta que solo se admiten imágenes PNG y JPEG, y que solo se admiten caracteres ASCII en los nombres de archivo de imagen.
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 en función de 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 la imagen.
Se supondrá que todas las imágenes tienen un ancho físico desconocido en metros.
Crear 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 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.
Identifica imágenes en el tiempo de ejecución
Usa AugmentedImage.getIndex()
y AugmentedImage.getName()
para identificar las imágenes detectadas.