> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/detections-shapes/detectors/find-reference.md).

# Find Reference

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

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

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

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

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

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

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

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

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

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

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

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

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

## 🎨 الميزات <a href="#features" id="features"></a>

* نتيجة مرئية مع تراكب مضلع للتحقق السريع.
* يعيد كل من القص المصحح بالمنظور والمخرجات الهندسية (الزوايا، المربع المحيط، المركز) للمعالجة التالية.
* يقبل ROI اختياري على صورة المرجع للتركيز على منطقة فرعية أثناء المطابقة.
* ينتج صورة تعليمية للنقاط المفتاحية لمساعدة تصحيح أخطاء جودة المطابقة.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. وزع صورة المصدر إلى `Object Image` والمرجع/القالب إلى `Reference Image`.
2. اختياريًا وصل شكلًا إلى `Reference Image ROI` لاستهداف منطقة محددة داخل المرجع.
3. شغّل السيناريو — سيحاول البلوك العثور على المرجع ويخرج نتائج مرئية معنونة وهندسة رقمية.
4. استخدم المخرجات للرسم فوق الصورة، القص، القياس أو التغذية إلى منطق اتخاذ القرار.

## 📊 كيف يعمل <a href="#evaluation" id="evaluation"></a>

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

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* للتركيز على منطقة محددة من صورة الإدخال، قم بالقص مسبقًا باستخدام `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` بعد الاكتشاف لاستخراج المنطقة المكتشفة وإرسالها إلى بلوكات معالجة أخرى.

## 🛠️ حل المشاكل <a href="#troubleshooting" id="troubleshooting"></a>

* لا يوجد اكتشاف: تأكد أن المرجع يظهر في صورة الهدف مع نسيج مرئي كافٍ؛ جرّب زيادة حجم المرجع في الصورة الهدف أو استخدم `Image Resize`.
* تطابق ضعيف أو غير مستقر: حسّن الإضاءة والتباين باستخدام `Adjust Colors` أو `Contrast Optimization`؛ قلل الضوضاء باستخدام `Blur`.
* اكتُشف ولكن المخرجات المشوهة تبدو خاطئة: تحقق من إحداثيات الزوايا باستخدام `Show Image` على `Keypoints Image` وفكّر في تقييد `Reference Image ROI`.
* بطء المعالجة على صور كبيرة: قلل القياس باستخدام `Image Resize` قبل إدخالها إلى البلوك، ثم قم بترجمة النتائج مرة أخرى إلى إحداثيات الصورة الأصلية إذا لزم الأمر.