أداة arcoreimg

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

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

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

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

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

نظام التشغيل Mac

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

نظام التشغيل Mac

./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 لتحديد ملف ملف ملف قائمة الصور كما هو موضّح أدناه:

نظام التشغيل Mac

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