הכלי arcoreimg

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() כדי לזהות תמונות שזוהו.