arcoreimg 도구

arcoreimg는 참조 이미지 세트를 가져와서 이미지 데이터베이스 파일을 생성하는 명령줄 도구입니다. 이 도구는 Android용 ARCore SDK (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()를 사용하여 감지된 이미지를 식별합니다.