arcoreimg एक कमांड-लाइन टूल है, जो रेफ़रंस इमेज का एक सेट लेता है और इमेज डेटाबेस फ़ाइल जनरेट करता है. यह टूल, Android के लिए ARCore SDK (टूल > arecoreimg देखें) में उपलब्ध है. यह सिर्फ़ Android और Android NDK डेवलपर के लिए है.
इस टूल की मदद से, रेफ़रंस इमेज की क्वालिटी भी देखी जा सकती है.
इमेज की क्वालिटी देखना
अच्छी रेफ़रंस इमेज को मानवीय आंखों से पहचानना मुश्किल होता है. हर इमेज के लिए 0 से 100 के बीच का क्वालिटी स्कोर पाने के लिए, arcoreimg eval-img चलाएं.
हमारा सुझाव है कि कम से कम 75 स्कोर वाली इमेज का इस्तेमाल करें.
macOS
./arcoreimg eval-img --input_image_path=dog.jpg
Windows
arcoreimg.exe eval-img --input_image_path=dog.png
इमेज डेटाबेस फ़ाइल बनाना
रेफ़रंस इमेज, डायरेक्ट्री में या इमेज की सूची वाली फ़ाइल (इसका सुझाव दिया जाता है) के ज़रिए दी जा सकती हैं. ध्यान दें कि सिर्फ़ PNG और JPEG इमेज काम करती हैं. साथ ही, इमेज की फ़ाइल के नाम में सिर्फ़ ASCII वर्ण इस्तेमाल किए जा सकते हैं.
इमेज की डायरेक्ट्री से इमेज डेटाबेस बनाना
--input_images_directory का इस्तेमाल करके arcoreimg build-db चलाएं, ताकि नीचे दी गई इमेज वाली डायरेक्ट्री के बारे में बताया जा सके:
macOS
./arcoreimg build-db --input_images_directory=/path/to/images \
--output_db_path=/path/to/myimages.imgdbWindows
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
हर लाइन में नाम, इमेज फ़ाइल का पाथ, और इमेज की मीटर में चौड़ाई (ज़रूरी नहीं) होती है.
इमेज सूची वाली फ़ाइल तय करने के लिए, --input_image_list_path का इस्तेमाल करके arcoreimg build-db चलाएं, जैसा कि यहां दिखाया गया है:
macOS
./arcoreimg build-db --input_image_list_path=/path/to/image_list_file.txt \
--output_db_path=/path/to/myimages.imgdbWindows
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() का इस्तेमाल करें.