arcoreimg ist ein Befehlszeilentool, mit dem eine Reihe von Referenzbildern in eine Bilddatenbankdatei umgewandelt wird. Dieses Tool ist im ARCore SDK for Android (siehe tools > arecoreimg) verfügbar und nur für Android- und Android NDK-Entwickler gedacht.
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 einer Bewertung von mindestens 75.
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 bereitstellen (bevorzugt). Es werden nur PNG- und JPEG-Bilder unterstützt. Dateinamen für Bilder dürfen nur ASCII-Zeichen enthalten.
Bilddatenbank aus einem Bildverzeichnis erstellen
Führen Sie arcoreimg build-db mit --input_images_directory aus, um ein Verzeichnis mit Ihren Bildern anzugeben, wie unten gezeigt:
macOS
./arcoreimg build-db --input_images_directory=/path/to/images \
--output_db_path=/path/to/myimages.imgdbWindows
arcoreimg.exe build-db --input_images_directory=/path/to/images --output_db_path=/path/to/myimages.imgdb
Jedem Bild wird ein Standardname zugewiesen, der auf seinem Pfad basiert. dog.jpg wird beispielsweise der Name /path/to/images/dog.jpg zugewiesen.
Jedem Bild wird außerdem ein 0-basierter Ganzzahlindex zugewiesen, der auf der ASCII-Sortierreihenfolge der Bilddateinamen basiert.
Bei allen Bildern wird davon ausgegangen, dass die physische Breite in Metern unbekannt ist.
Datenbank aus einer Bildlistendatei erstellen (bevorzugt)
Das Format der Bildlistendatei ist unten dargestellt:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Jede Zeile enthält einen Namen, den Pfad zur Bilddatei und die physische Breite des Bildes in Metern (optional).
Führen Sie arcoreimg build-db mit --input_image_list_path aus, um eine Bildlistendatei anzugeben, wie unten gezeigt:
macOS
./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
--output_db_path=/path/to/myimages.imgdbWindows
arcoreimg.exe build-db --input_image_list_path=/path/to/image_list_file.txt --output_db_path=/path/to/myimages.imgdb
Jedem Bild wird ein Name und ein 0-basierter Index zugewiesen, der auf seiner Position in der Bildlistendatei basiert.
Bilder zur Laufzeit identifizieren
Verwenden Sie AugmentedImage.getIndex() und AugmentedImage.getName(), um erkannte Bilder zu identifizieren.