Công cụ arcoreimg

arcoreimg là một công cụ dòng lệnh lấy một tập hợp hình ảnh tham chiếu và tạo một tệp cơ sở dữ liệu hình ảnh. Công cụ này có trong SDK ARCore cho Android (xem tools > arecoreimg) và chỉ dành cho nhà phát triển Android và Android NDK.

Công cụ này cũng cho phép bạn kiểm tra chất lượng của hình ảnh tham chiếu.

Kiểm tra chất lượng hình ảnh

Mắt người khó phát hiện được hình ảnh tham chiếu tốt. Chạy arcoreimg eval-img để nhận điểm chất lượng từ 0 đến 100 cho mỗi hình ảnh.

Bạn nên sử dụng hình ảnh có điểm số ít nhất là 75.

macOS

./arcoreimg eval-img --input_image_path=dog.jpg

Windows

arcoreimg.exe eval-img --input_image_path=dog.png

Tạo tệp cơ sở dữ liệu hình ảnh

Bạn có thể cung cấp hình ảnh tham chiếu trong một thư mục hoặc thông qua tệp danh sách hình ảnh (ưu tiên). Xin lưu ý rằng chúng tôi chỉ hỗ trợ hình ảnh PNG và JPEG, đồng thời chỉ hỗ trợ các ký tự ASCII trong tên tệp hình ảnh.

Tạo cơ sở dữ liệu hình ảnh từ một thư mục hình ảnh

Chạy arcoreimg build-db bằng --input_images_directory để chỉ định một thư mục chứa hình ảnh của bạn như minh hoạ dưới đây:

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

Mỗi hình ảnh được chỉ định một tên mặc định dựa trên đường dẫn của hình ảnh đó. Ví dụ: dog.jpg được gán tên là /path/to/images/dog.jpg.

Mỗi hình ảnh cũng được chỉ định một chỉ mục số nguyên dựa trên 0, dựa trên thứ tự sắp xếp ASCII của tên tệp hình ảnh.

Tất cả hình ảnh sẽ được giả định có chiều rộng thực tế không xác định tính bằng mét.

Tạo cơ sở dữ liệu từ tệp danh sách hình ảnh (Ưu tiên)

Định dạng của tệp danh sách hình ảnh được hiển thị bên dưới:

mouse|path/to/mouse.png|0.1
little dog|/path/to/dog.jpg

Mỗi dòng chứa một tên, đường dẫn tệp hình ảnh và chiều rộng thực tế của hình ảnh tính bằng mét (không bắt buộc).

Chạy arcoreimg build-db bằng --input_image_list_path để chỉ định tệp danh sách hình ảnh như minh hoạ dưới đây:

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

Mỗi hình ảnh được chỉ định một tên và một chỉ mục dựa trên 0 dựa trên vị trí của hình ảnh đó trong tệp danh sách hình ảnh.

Xác định hình ảnh trong thời gian chạy

Sử dụng AugmentedImage.getIndex() và AugmentedImage.getName() để xác định hình ảnh được phát hiện.