> 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-object.md).

# Find Object

يساعدك هذا البلوك الوظيفي على تحديد موقع صورة قالب أصغر داخل صورة أكبر باستخدام طرق مطابقة قابلة للاختيار وشريط تمرير حساسية قابل للتعديل. يوفر مخرجات بصرية ومعلومات مواقع تفصيلية للمساعدة في التفتيش، العد والمعالجة اللاحقة.

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

يقبل هذا البلوك المنافذ/المداخل التالية:

* `Main Image` يستقبل الصورة التي سيتم البحث داخلها عن الكائن.
* `Object Image` يستقبل صورة القالب للكائن المراد العثور عليه (قالب واحد أو قائمة قوالب).

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

يوفر هذا البلوك المآخذ/المخرجات التالية:

* `Image Any` ناتج بصري تُعرض فيه التطابقات المكتشفة مميزة.
* `Object Positions` إحداثيات مراكز الكائنات المكتشفة (متعددة).
* `Object Count` عدد الكائنات المكتشفة.
* `Rectangle Coordinates` مستطيلات التغليف لكل كائن مكتشف (متعددة).

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

* `Method` اختر خوارزمية مطابقة القالب من القائمة المتاحة.
* `Match Threshold %` اضبط شريط التمرير للتحكم بصرامة المطابقة. القيم الأعلى تقلل الإيجابيات الكاذبة لكنها قد تفوت التطابقات الضعيفة.
* `Result` يعرض عدد الكائنات المكتشفة لتغذية راجعة سريعة.

## 🎯 الميزات الرئيسية <a href="#features" id="features"></a>

* تراكب بصري للتطابقات على الصورة المدخلة للتحقق السريع.
* مآخذ مخرجات متعددة توفر نتائج بصرية ورقمية للمعالجة اللاحقة.
* يعمل مع قالب واحد أو قائمة قوالب للعثور على أفضل تطابق متاح.

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

1. أدخل صورة المصدر إلى منفذ `Main Image`.
2. أدخل قالبًا واحدًا أو قائمة قوالب إلى منفذ `Object Image`.
3. اختر `Method` التي تناسب خصائص المشهد والقالب.
4. اضبط شريط `Match Threshold %` حتى تكون دقة الاكتشاف مقبولة.
5. افحص النتائج باستخدام الناتج البصري والمآخذ الرقمية.

## ⚙️ ماذا يحدث عند التشغيل <a href="#evaluation" id="evaluation"></a>

عند التشغيل، يبحث البلوك في `Main Image` عن مناطق تطابق `Object Image` بحسب الطريقة والعتبة المحددة. يعيد تصورًا بصريًا، مواقع مراكز الاكتشافات، عددها، وإحداثيات مستطيلات التغليف.

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

* لتقليل المطابقات الخاطئة من الصور المشوشة، مرّر الصورة عبر `Blur` أو `Denoising` قبل هذا البلوك.
* إذا اختلفت أحجام القوالب والصورة الرئيسية، استخدم `Image Resize` لتوحيد الأحجام لنتائج أكثر موثوقية.
* للتركيز على منطقة محددة فقط، اقتطع الصورة أولًا باستخدام `Image ROI Select` وادخل الصورة المقتطعة إلى هذا البلوك.
* بعد الاكتشاف، استخدم `Rectangles in Rectangle` لتصفية الاكتشافات خارج منطقة الاهتمام.
* اعرض وتحقق من الاكتشافات باستخدام بلوك `Show Image` للتأكيد التفاعلي.
* احفظ لقطات مثيرة للاهتمام أو حالات الفشل باستخدام `Image Logger` أو `Image Write` للمراجعة والمعايرة.
* للمشاهد المعقدة أو عند وجود عدة فئات كائنات، فكّر في الجمع مع بلوكات `Object Detection` أو `Object Detection - Custom` عندما تصبح مطابقة القوالب غير موثوقة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا لم يتم العثور على كائنات، جرّب خفض قيمة `Match Threshold %` أو تحسين تباين القالب بمعالجات مسبقة مثل `Contrast Optimization` أو `Adjust Colors`.
* إذا ظهرت العديد من الإيجابيات الكاذبة، زد قيمة `Match Threshold %` وفكّر في ترشيح الصورة باستخدام `HSV Filter` أو `Image Threshold` لإبراز الكائن.
* إذا تنوعت النتائج بين الصور، تأكد من أن القوالب متوافقة مع المظهر المتوقع (مقياس، تدوير، إضاءة) أو استخدم عدة قوالب عبر منفذ `Object Image`.