arcoreimg ist ein Befehlszeilentool, das anhand einer Reihe von Referenzbildern eine Bilddatenbankdatei generiert. 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 kannst du auch die Qualität deiner 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 einen Qualitätsfaktor zwischen 0 und 100 für jedes Bild zu erhalten.
Wir empfehlen, Bilder mit einer Punktzahl 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 Bilderlistendatei (bevorzugt) bereitstellen. Es werden nur PNG- und JPEG-Bilder unterstützt und in Bilddateinamen werden nur ASCII-Zeichen unterstützt.
Bilddatenbank aus einem Bildverzeichnis erstellen
Führen Sie arcoreimg build-db mit --input_images_directory aus, um wie unten gezeigt ein Verzeichnis anzugeben, das Ihre Images 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. dog.jpg wird beispielsweise /path/to/images/dog.jpg als Name zugewiesen.
Jedem Bild wird außerdem ein 0-basierter Ganzzahlindex zugewiesen, der auf der ASCII-Sortierreihenfolge der Bilddateinamen basiert.
Es wird angenommen, dass alle Bilder eine unbekannte physische Breite in Metern haben.
Datenbank aus einer Image-Listendatei erstellen (bevorzugt)
Das Format der Image-Listendatei sieht so aus:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
Jede Zeile enthält einen Namen, den Bilddateipfad und die physische Breite in Metern des Bildes (optional).
Führen Sie arcoreimg build-db mit --input_image_list_path aus, um eine Image-Listendatei anzugeben, wie unten gezeigt:
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 Image wird basierend auf seiner Position in der Image-Listendatei ein name und ein 0-basierter Index zugewiesen.
Images zur Laufzeit identifizieren
Verwenden Sie AugmentedImage.getIndex() und AugmentedImage.getName(), um erkannte Bilder zu identifizieren.