arcoreimg to narzędzie wiersza poleceń, które pobiera zestaw obrazów referencyjnych i generuje plik bazy danych obrazów. Narzędzie jest dostępne w pakiecie SDK ARCore SDK na Androida (zobacz narzędzia > arecoreimg) i jest przeznaczone tylko dla deweloperów pakietów NDK na Androida i Androida.
Narzędzie to pozwala też sprawdzić jakość obrazów referencyjnych.
Sprawdź jakość zdjęcia
Dobry obraz referencyjny jest trudny do rozpoznania dla ludzkiego oka. Uruchom arcoreimg eval-img, aby uzyskać wynik jakości dla każdego obrazu w zakresie od 0 do 100.
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
Zdjęcia referencyjne możesz dostarczyć w katalogu lub za pomocą pliku z listą obrazów (zalecane). Pamiętaj, że obsługiwane są wyłącznie obrazy PNG i JPEG, a w nazwach plików graficznych można używać wyłącznie znaków ASCII.
Utwórz bazę danych obrazów na podstawie katalogu obrazów
Uruchom arcoreimg build-db, używając --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żdy obraz otrzymuje domyślną nazwę na podstawie ścieżki. Na przykład nazwę dog.jpg przypisano /path/to/images/dog.jpg.
Do każdego obrazu jest też przypisywany indeks liczby całkowitej, który jest oparty na 0, zgodnie z kolejnością sortowania według znaków ASCII nazw plików obrazów.
Przyjmujemy, że wszystkie obrazy mają nieznaną szerokość fizyczną w metrach.
Utwórz bazę danych z pliku z listą obrazów (opcja preferowana)
Plik z listą obrazów ma format przedstawiony 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 fizyczną szerokość obrazu w metrach (opcjonalnie).
Uruchom arcoreimg build-db przy użyciu --input_image_list_path, aby określić plik z listą 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 na podstawie jego pozycji w pliku z listą obrazów przypisywany jest nazwa i indeks oparty na 0.
Identyfikowanie obrazów w czasie działania
Do identyfikowania wykrytych obrazów używaj funkcji AugmentedImage.getIndex() i AugmentedImage.getName().