arcoreimg 工具

arcoreimg 這個指令列工具可接收一組參考圖片並產生 映像檔資料庫檔案這項工具由 ARCore SDK for Android (請參閱 Tools > iscoreimg)。 僅供 Android 和 Android NDK 開發人員使用。

你也可以透過這項工具確認參考圖片的品質。

檢查圖片品質

理想的參考圖片並不容易在人眼中認出。執行 arcoreimg eval-img 以取得每張圖片的品質分數介於 0100 之間。

建議使用至少 75 分的圖片。

macOS

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

Windows

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

建立映像檔資料庫檔案

您可以透過目錄圖片清單檔案 (建議) 提供參考圖片。 請注意,系統僅支援 PNG 和 JPEG 圖片,且只支援 ASCII 字元 。

從映像檔目錄建立映像檔資料庫

使用 --input_images_directory 執行 arcoreimg build-db 以指定 包含映像檔的目錄,如下所示:

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

系統會根據圖片路徑,為每張映像檔指派預設名稱。例如:dog.jpg 已將 /path/to/images/dog.jpg 指定為它的名稱。

系統也會依據 ASCII 順序,為每張圖片指派一個以 0 為基礎的整數索引 圖片檔案名稱的順序。

所有圖片的實體寬度 (以公尺為單位) 皆不明。

從映像檔清單檔案建立資料庫 (建議使用)

圖片清單檔案的格式如下所示:

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

每一行都包含名稱圖片檔路徑和映像檔 實際寬度,單位為公尺 (選用)。

使用 --input_image_list_path 執行 arcoreimg build-db,以指定映像檔 清單檔案,如下所示:

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

系統會根據每張圖片指派一個名稱和一個以 0 為基礎的索引

在執行階段識別圖片

使用 AugmentedImage.getIndex()AugmentedImage.getName() 找出偵測到的圖片