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.
./arcoreimg eval-img --input_image_path=dog.jpg
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:
./arcoreimg build-db --input_images_directory=/path/to/images \ --output_db_path=/path/to/myimages.imgdb
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:
./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \ --output_db_path=/path/to/myimages.imgdb
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.