arcoreimg
הוא כלי של שורת הפקודה שמצלם קבוצה של תמונות עזר ויוצר קובץ מסד נתונים של תמונות. הכלי הזה זמין ב-ARCore SDK ל-Android (ראו tools > arecoreimg), והוא מיועד רק למפתחי NDK ב-Android וב-Android.
הכלי גם מאפשר לכם לבדוק את האיכות של התמונות להמחשה.
בדיקת איכות התמונה
קשה לאתר תמונת הפניה טובה בעין אנושית. מריצים את הפקודה 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
לכל תמונה מוקצה שם ברירת מחדל על סמך הנתיב שלה. לדוגמה, השם /path/to/images/dog.jpg
יוקצה ל-dog.jpg
.
לכל תמונה מוקצה גם אינדקס של מספרים שלמים שמבוססים על 0
, על סמך סדר המיון של ה-ASCII של שמות הקבצים של התמונות.
ההנחה של כל התמונות תהיה שהרוחב הפיזי לא ידוע במטרים.
יצירת מסד נתונים מקובץ רשימת תמונות (מועדף)
הפורמט של קובץ רשימת התמונות מוצג בהמשך:
mouse|path/to/mouse.png|0.1 little dog|/path/to/dog.jpg
כל שורה מכילה name, את נתיב קובץ התמונה ואת הרוחב הפיזי של התמונה במטרים (אופציונלי).
כדי לציין קובץ רשימת תמונות, מריצים את 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
לכל תמונה מוקצה שם ו-index שמבוסס על 0
, על סמך המיקום שלו בקובץ רשימת התמונות.
זיהוי תמונות בזמן ריצה
משתמשים ב-AugmentedImage.getIndex()
וב-AugmentedImage.getName()
כדי לזהות תמונות שזוהו.