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()를 사용하여 감지된 이미지를 식별합니다.