Find Reference

تقوم هذه الدالة بتحديد مثيل واحد لصورة مرجعية داخل صورة الهدف، وتقدير موضعه واتجاهه، ثم إرجاع نتائج مرئية وهندسية تساعدك على فحص أو معالجة العنصر المكتشف لاحقًا.

📥 المدخلات

Object Image الصورة التي يجب أن يتم البحث بداخلها (الصورة الهدف).

Reference Image الصورة المرجعية الصغيرة المستخدمة للبحث داخل Object Image.

Reference Image ROI إدخال شكل اختياري لتقييد المطابقة على منطقة داخل صورة المرجع (مفيد لتجاهل أجزاء غير ذات صلة).

📤 المخرجات

Result Image صورة الهدف معنونة بالمضلع المحيط بالمرجع المكتشف.

Detected Object Image قص مُصحَّح بالمنظور للكائن المكتشف، محوَّل ليتطابق مع اتجاه/حجم المرجع.

Keypoints Image تصور لاكتشاف الميزات/النقاط المفتاحية على صورة الهدف لمساعدة التحقق من التطابقات.

Bounding Box المستطيل المحيط الذي يحيط بالمرجع المكتشف في صورة الهدف.

Corner Coordinates إحداثيات زوايا المضلع الأربعة لمنطقة المرجع المكتشفة.

Center Position نقطة المركز (x, y) للمرجع المكتشف.

🕹️ الضوابط

لا يعرض هذا المربع عناصر واجهة إضافية بخلاف مدخلاته. استخدم إدخال Reference Image ROI لتحديد منطقة المرجع عند الحاجة.

🎨 الميزات

• نتيجة مرئية مع تراكب مضلع للتحقق السريع.

• يعيد كل من القص المصحح بالمنظور والمخرجات الهندسية (الزوايا، المربع المحيط، المركز) للمعالجة التالية.

• يقبل ROI اختياري على صورة المرجع للتركيز على منطقة فرعية أثناء المطابقة.

• ينتج صورة تعليمية للنقاط المفتاحية لمساعدة تصحيح أخطاء جودة المطابقة.

📝 تعليمات الاستخدام

1. وزع صورة المصدر إلى Object Image والمرجع/القالب إلى Reference Image.

2. اختياريًا وصل شكلًا إلى Reference Image ROI لاستهداف منطقة محددة داخل المرجع.

3. شغّل السيناريو — سيحاول البلوك العثور على المرجع ويخرج نتائج مرئية معنونة وهندسة رقمية.

4. استخدم المخرجات للرسم فوق الصورة، القص، القياس أو التغذية إلى منطق اتخاذ القرار.

📊 كيف يعمل

عند التنفيذ، يقارن البلوك الميزات البصرية المميزة بين صورة المرجع وصورة الهدف، يقدّر موضع واتجاه أفضل تطابق، ويعيد تعليقًا مرئيًا بالإضافة إلى مخرجات مُحوَّلة وهندسية رقمية تمثل العنصر المُكتَشف.

💡 نصائح وحيل

• للتركيز على منطقة محددة من صورة الإدخال، قم بالقص مسبقًا باستخدام Image ROI Select أو Image ROI ومرّر الصورة المقتصة إلى Object Image.

• إذا كانت المقياس أو الاتجاه مختلفًا بشكل كبير بين المرجع والهدف، جرّب تغيير حجم المدخلات باستخدام Image Resize قبل المطابقة.

• حسّن المتانة تحت إضاءة متغيرة باستخدام معالجة مسبقة مثل Adjust Colors أو Contrast Optimization أو Blur لتقليل الضوضاء.

• استخدم Show Image لمعاينة Result Image أو Detected Object Image تفاعليًا أثناء ضبط المدخلات.

• ادمج مخرجات البلوك مع Draw Detections أو Draw Result On Image لتراكب تعليقات نصية أو مستطيلات على الصور الحية.

• إذا احتجت مصفوفة تحويل منظور لقياسات أخرى، ففكر في متابعة العملية بـ Perspective Transform باستخدام إحداثيات الزوايا المكتشفة.

• عندما تُعيد المطابقة عددًا كبيرًا من الإيجابيات الخاطئة، جرّب تقييد ميزات المرجع باستخدام Reference Image ROI أو تطبيق Image Threshold على المدخلات لتبسيط النسيج.

(تلميح) لعمليات سير العمل المعتمدة على المنطقة، استخدم Get ROI بعد الاكتشاف لاستخراج المنطقة المكتشفة وإرسالها إلى بلوكات معالجة أخرى.

🛠️ حل المشاكل

• لا يوجد اكتشاف: تأكد أن المرجع يظهر في صورة الهدف مع نسيج مرئي كافٍ؛ جرّب زيادة حجم المرجع في الصورة الهدف أو استخدم Image Resize.

• تطابق ضعيف أو غير مستقر: حسّن الإضاءة والتباين باستخدام Adjust Colors أو Contrast Optimization؛ قلل الضوضاء باستخدام Blur.

• اكتُشف ولكن المخرجات المشوهة تبدو خاطئة: تحقق من إحداثيات الزوايا باستخدام Show Image على Keypoints Image وفكّر في تقييد Reference Image ROI.

• بطء المعالجة على صور كبيرة: قلل القياس باستخدام Image Resize قبل إدخالها إلى البلوك، ثم قم بترجمة النتائج مرة أخرى إلى إحداثيات الصورة الأصلية إذا لزم الأمر.