arcoreimg 工具

arcoreimg 是一項指令列工具,可擷取一組參考圖片並產生圖片資料庫檔案。這項工具適用於 Android 的 ARCore SDK (請依序點選「工具」>「 arecoreimg」),且僅適用於 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

系統會根據圖片路徑為每張映像檔指派預設名稱。例如,指派 /path/to/images/dog.jpg 做為 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() 來識別偵測到的圖片。