Das Tool „arcoreimg“

arcoreimg ist ein Befehlszeilentool, das anhand einer Reihe von Referenzbildern generiert, eine Bilddatenbankdatei. Dieses Tool ist in der ARCore SDK for Android (siehe Tools > arecoreimg) und nur für Android- und Android NDK-Entwickler.

Mit dem Tool können Sie auch die Qualität Ihrer Referenzbilder prüfen.

Bildqualität prüfen

Ein gutes Referenzbild ist für das menschliche Auge schwer zu erkennen. Führen Sie arcoreimg eval-img aus, um für jedes Bild einen Qualitätsfaktor zwischen 0 und 100 zu erhalten.

Wir empfehlen, Bilder mit einem Wert von mindestens 75 zu verwenden.

macOS

./arcoreimg eval-img --input_image_path=dog.jpg

Windows

arcoreimg.exe eval-img --input_image_path=dog.png

Bilddatenbankdatei erstellen

Sie können Referenzbilder in einem Verzeichnis oder über eine Bildlistendatei (bevorzugt) bereitstellen. Beachten Sie, dass nur PNG- und JPEG-Bilder unterstützt werden und nur ASCII-Zeichen verwendet werden. die in Bilddateinamen unterstützt werden.

Image-Datenbank aus einem Verzeichnis mit Bildern erstellen

Führen Sie arcoreimg build-db mit --input_images_directory aus, um Folgendes anzugeben: das Ihre Bilder enthält:

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

Jedem Image wird basierend auf seinem Pfad ein Standardname zugewiesen. Beispiel: dog.jpg wird /path/to/images/dog.jpg als Name zugewiesen.

Jedem Bild wird basierend auf der ASCII-Sortierung auch ein 0-basierter ganzzahliger Index zugewiesen Reihenfolge der Bilddateinamen.

Es wird angenommen, dass alle Bilder eine unbekannte physische Breite in Metern haben.

Datenbank aus einer Bildlistendatei erstellen (bevorzugt)

Das Format der Image-Listendatei lautet wie folgt:

mouse|path/to/mouse.png|0.1
little dog|/path/to/dog.jpg

Jede Zeile enthält einen Namen, den Pfad zur Bilddatei und den Physische Breite in Metern (optional).

Führen Sie arcoreimg build-db mit --input_image_list_path aus, um ein Image anzugeben. Listendatei wie unten zu sehen:

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

Jedem Bild werden ein Name und ein 0-basierter Index basierend auf seinen Position in der Bildlistendatei fest.

Bilder während der Laufzeit identifizieren

AugmentedImage.getIndex() verwenden und AugmentedImage.getName() um erkannte Bilder zu identifizieren.