Narzędzie arcoreimg

arcoreimg to narzędzie wiersza poleceń, które pobiera zestaw obrazów referencyjnych i generuje plik bazy danych obrazów. To narzędzie jest dostępne w pakiecie ARCore SDK na Androida (patrz Narzędzia > arecoreimg) i jest przeznaczone tylko dla deweloperów aplikacji na Androida i Androida NDK.

Narzędzie pozwala też sprawdzić jakość obrazów referencyjnych.

Sprawdzanie jakości obrazu

Dobry obraz referencyjny jest trudny do zauważenia przez ludzkie oko. Uruchom arcoreimg eval-img, aby uzyskać wynik jakości w zakresie od 0 do 100 dla każdego obrazu.

Zalecamy używanie zdjęć o ocenie co najmniej 75.

macOS

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

Windows

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

Tworzenie pliku bazy danych obrazów

Obrazy referencyjne możesz podać w katalogu lub za pomocą pliku z listą obrazów (preferowana opcja). Pamiętaj, że obsługiwane są tylko obrazy PNG i JPEG, a w nazwach plików obrazów można używać tylko znaków ASCII.

Tworzenie bazy danych obrazów na podstawie katalogu obrazów

Uruchom arcoreimg build-db, używając opcji --input_images_directory, aby określić katalog zawierający obrazy, jak pokazano poniżej:

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

Każdemu obrazowi przypisana jest domyślna nazwa na podstawie jego ścieżki. Na przykład identyfikatorowi dog.jpg przypisano nazwę /path/to/images/dog.jpg.

Każdemu obrazowi przypisuje się też indeks całkowitoliczbny 0 na podstawie kolejności sortowania ASCII nazw plików obrazów.

Zakłada się, że wszystkie obrazy mają nieznaną fizyczną szerokość w metrach.

Tworzenie bazy danych z pliku z listą obrazów (preferowane)

Format pliku listy obrazów:

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

Każdy wiersz zawiera nazwę, ścieżkę do pliku obrazu oraz fizyczną szerokość obrazu w metrach (opcjonalnie).

Uruchom arcoreimg build-db za pomocą --input_image_list_path, aby określić plik listy obrazów, jak pokazano poniżej:

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

Każdemu obrazowi przypisana jest nazwa i indeks oparty na 0, który określa jego pozycję w pliku z listą obrazów.

Identyfikowanie obrazów w czasie wykonywania

Użyj AugmentedImage.getIndex() i AugmentedImage.getName(), aby zidentyfikować wykryte obrazy.