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