arcoreimg
เป็นเครื่องมือบรรทัดคำสั่งที่ใช้ชุดรูปภาพอ้างอิงเพื่อสร้างไฟล์ฐานข้อมูลรูปภาพ เครื่องมือนี้พร้อมใช้งานใน ARCore SDK สําหรับ Android (ดูเครื่องมือ > 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 ในชื่อไฟล์รูปภาพ
สร้างฐานข้อมูลรูปภาพจากไดเรกทอรีรูปภาพ
เรียกใช้ arcoreimg build-db
โดยใช้ --input_images_directory
เพื่อระบุไดเรกทอรีที่มีรูปภาพดังที่แสดงด้านล่าง
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
เป็นชื่อ
รูปภาพแต่ละรูปจะได้รับการกำหนดดัชนีจำนวนเต็มตาม 0
ด้วย โดยอิงตามลําดับการจัดเรียง ASCII ของชื่อไฟล์รูปภาพ
ระบบจะถือว่ารูปภาพทั้งหมดมีความกว้างจริงเป็นเมตรที่ไม่รู้จัก
สร้างฐานข้อมูลจากไฟล์รายการรูปภาพ (แนะนำ)
รูปแบบของไฟล์รายการรูปภาพแสดงอยู่ด้านล่าง
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
แต่ละบรรทัดจะมีชื่อ เส้นทางไฟล์รูปภาพ และความกว้างจริงของรูปภาพเป็นเมตร (ไม่บังคับ)
เรียกใช้ arcoreimg build-db
โดยใช้ --input_image_list_path
เพื่อระบุไฟล์รายการรูปภาพดังที่แสดงด้านล่าง
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()
เพื่อระบุรูปภาพที่ตรวจพบ