arcoreimg
是一項指令列工具,可擷取一組參考圖片並產生圖片資料庫檔案。這項工具適用於 Android 的 ARCore SDK (請依序點選「工具」>「 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
系統會根據圖片路徑為每張映像檔指派預設名稱。例如,指派 /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()
來識別偵測到的圖片。