Narzędzie arcoreimg

arcoreimg to narzędzie wiersza poleceń, które pobiera zbiór obrazów referencyjnych i generuje lub pliku bazy danych zdjęć. To narzędzie jest dostępne w ARCore SDK na Androida (patrz narzędzia > arecoreimg), i jest przeznaczona tylko dla programistów Androida i Androida NDK.

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

Sprawdź jakość obrazu

Dobry obraz referencyjny jest trudny do zauważenia gołym okiem. Uruchom arcoreimg eval-img, aby uzyskać wynik jakości między 0 a 100 dla każdego obrazu.

Zalecamy używanie obrazów z wynikiem 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 dostarczyć do katalogu lub za pomocą pliku listy obrazów (zalecane). Obsługiwane są wyłącznie obrazy w formatach PNG i JPEG oraz jedynie znaki ASCII obsługiwane w nazwach plików obrazów.

Tworzenie bazy danych obrazów na podstawie katalogu zdjęć

Uruchom arcoreimg build-db za pomocą polecenia --input_images_directory, aby określić katalogu z Twoimi obrazami, 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 jest przypisywana domyślna nazwa na podstawie jego ścieżki. Na przykład: dog.jpg ma przypisaną nazwę /path/to/images/dog.jpg.

Do każdego obrazu przypisywany jest też indeks całkowity oparty na 0, oparty na sortowaniu ASCII według nazw plików obrazów.

Zakładamy, że wszystkie obrazy mają nieznaną fizyczną szerokość wyrażoną w metrach.

Utwórz bazę danych na podstawie pliku listy obrazów (preferowane)

Format pliku listy obrazów znajduje się poniżej:

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

Każdy wiersz zawiera nazwę, ścieżkę pliku obrazu i tag szerokość fizyczna w metrach (opcjonalnie).

Uruchom arcoreimg build-db za pomocą polecenia --input_image_list_path, aby określić obraz z listą plikó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żdy obraz ma przypisaną nazwę i indeks oparty na 0 pozycji w pliku listy obrazów.

Identyfikowanie obrazów w czasie działania

Użyj formatu AugmentedImage.getIndex() i AugmentedImage.getName() do rozpoznawania wykrytych obrazów.