arcoreimg ツール

arcoreimg は、一連の参照画像を受け取って画像データベース ファイルを生成するコマンドライン ツールです。このツールは ARCore SDK for Android で利用できます（[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() を使用して、検出された画像を識別します。