הכלי arcoreimg

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