arcoreimg 도구

arcoreimg은 참조 이미지 집합을 가져와서 이미지 데이터베이스 파일을 생성하는 명령줄 도구입니다. 이 도구는 Android용 ARCore SDK에서 사용할 수 있으며 Android 및 Android NDK 개발자만 사용할 수 있습니다. 이 SDK는 Unity SDK와 ARCore Unreal 플러그인에 내장되어 있습니다.

또한 이 도구를 사용하면 참조 이미지의 품질을 확인할 수 있습니다.

이미지 품질 확인

좋은 참조 이미지는 사람의 눈으로는 파악하기 어렵습니다. 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()를 사용하여 감지된 이미지를 식별합니다.