arcoreimg은 참조 이미지 집합을 가져와서 이미지 데이터베이스 파일을 생성하는 명령줄 도구입니다. 이 도구는 Android용 ARCore SDK에서 사용할 수 있으며 Android 및 Android NDK 개발자만 사용할 수 있습니다. 이 SDK는 Unity SDK와 ARCore Unreal 플러그인에 내장되어 있습니다.
또한 이 도구를 사용하면 참조 이미지의 품질을 확인할 수 있습니다.
이미지 품질 확인
좋은 참조 이미지는 사람의 눈으로는 파악하기 어렵습니다. 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()를 사용하여 감지된 이미지를 식별합니다.