arcoreimg 工具

arcoreimg 是一項指令列工具，可擷取一組參考圖片並產生圖片資料庫檔案。這項工具可在 Android 適用的 ARCore SDK 中使用 (請參閱「tools」>「arecoreimg」)，且僅供 Android 和 Android NDK 開發人員使用。

您也可以使用這項工具檢查參考圖片的品質。

檢查相片品質

好的參考圖片很難用肉眼辨識。執行 arcoreimg eval-img 即可為每張圖片取得介於 0 和 100 之間的品質分數。

建議使用至少 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() 識別偵測到的圖片。