أداة arcoreimg

arcoreimg هي أداة سطر الأوامر التي تلتقط مجموعة من الصور المرجعية وتنشئها ملف قاعدة بيانات صورة. تتوفر هذه الأداة في حزمة SDK الخاصة بإصدار ARCore لنظام التشغيل Android (اطّلِع على الأدوات > arecoreimg) وهي مخصّصة لمطوّري برامج Android وAndroid NDK فقط.

تتيح لك الأداة أيضًا التحقّق من جودة صورك المرجعية.

التحقّق من جودة الصور

يصعب كشف الصورة المرجعية الجيدة بالعين المجردة. شغِّل arcoreimg eval-img للحصول على نقاط جودة تتراوح بين 0 و100 لكل صورة.

ننصحك باستخدام صور حصلت على نتيجة 75 على الأقل.

./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 لتحديد الدليل الذي يحتوي على صورك كما هو موضح أدناه:

./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

يتم تخصيص اسم تلقائي لكل صورة استنادًا إلى مسارها. على سبيل المثال: 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 لتحديد صورة ملف القائمة كما هو موضح أدناه:

./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() لتحديد الصور التي تم اكتشافها.