הכלי arcoreimg

arcoreimg הוא כלי שורת פקודה שמקבל קבוצה של תמונות לדוגמה ויוצר קובץ של מסד נתונים של תמונות. הכלי הזה זמין ב-ARCore SDK for Android (tools > arecoreimg), והוא מיועד רק למפתחי Android ו-Android NDK.

בעזרת הכלי אפשר גם לבדוק את האיכות של תמונות העזר.

בדיקת איכות התמונה

קשה לזהות תמונה טובה של עזר בעין האנושית. מריצים את הפקודה arcoreimg eval-img כדי לקבל ציון איכות בין 0 ל-100 לכל תמונה.

מומלץ להשתמש בתמונות עם ציון של 75 לפחות.

macOSWindows

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

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

יצירת קובץ של מסד נתונים של תמונות

אפשר לספק תמונות לדוגמה בספרייה או באמצעות קובץ רשימת תמונות (עדיף). לתשומת ליבכם: יש תמיכה רק בתמונות בפורמט PNG ו-JPEG, ורק בתווי ASCII בשמות של קובצי תמונות.

יצירת מסד נתונים של תמונות מספריית תמונות

מריצים את arcoreimg build-db באמצעות --input_images_directory כדי לציין את הספרייה שמכילה את התמונות, כפי שמתואר בהמשך:

macOSWindows

./arcoreimg build-db --input_images_directory=/path/to/images \
                       --output_db_path=/path/to/myimages.imgdb

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

כל שורה מכילה שם, את נתיב קובץ התמונה ואת הרוחב הפיזי של התמונה במטרים (אופציונלי).

מריצים את arcoreimg build-db באמצעות --input_image_list_path כדי לציין קובץ של רשימת תמונות, כפי שמתואר בהמשך:

macOSWindows

./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
                       --output_db_path=/path/to/myimages.imgdb

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