arcoreimg ツール

arcoreimg は、一連の参照画像を取得して生成するコマンドライン ツールです。 画像データベース ファイルが作成されます。このツールは ARCore SDK for Android[tools] > [ 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

各イメージには、パスに基づいてデフォルトの名前が割り当てられます。例: 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() 画像を特定します。