> 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/roi-processing/rectangles-in-rectangle.md).

# Rectangles in Rectangle

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

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

`Image Any`\
الصورة الرئيسية المستخدمة للعرض والفحوص. يتم رسم المستطيل المرجعي والمستطيلات المرشّحة على هذه الصورة للتغذية البصرية.

`Rectangle`\
المستطيل المرجعي المعرفة بنقطتي زاوية (الزاوية العليا اليسرى والزاوية السفلى اليمنى). إذا تُرك فارغًا، تُستخدم كامل مساحة الصورة كمرجع.

`Rectangles`\
مستطيل واحد أو عدة مستطيلات مرشّحة ليتم فحصها مقابل المستطيل المرجعي. يقبل قائمة أزواج إحداثيات.

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

`Result`\
صورة مشروحة تُظهر المستطيل المرجعي وكل المستطيلات المرشّحة. المستطيلات الموجودة داخل المنطقة المرجعية مرسومة باللون الأخضر وموسومة `OK`؛ والمستطيلات الخارجة مرسومة باللون الأحمر وموسومة `NOK`.

`Not Empty`\
قيمة بوليانية True عندما يكون هناك مستطيل واحد على الأقل داخل المستطيل المرجعي.

`Count`\
عدد المستطيلات المرشّحة التي وُجدت داخل المستطيل المرجعي.

`Rectangles`\
قائمة بإحداثيات المستطيلات التي تحدد أنها داخل المستطيل المرجعي.

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

`No Controls`\
هذا البلوك لا يتطلب عناصر واجهة إضافية؛ يتم التحكم في سلوكه بالكامل عبر مداخله (المستطيل المرجعي والمستطيلات المرشّحة). استخدم بلوكات أو أدوات واجهة أخرى لإنشاء أو تعديل مدخلات المستطيل.

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

* تأكيد بصري: تُظهر الصورة الناتجة بوضوح المنطقة المرجعية وتُرسم كل مستطيل مرشّح مع حالة ملونة وتسميات نصية.
* مرجع مرن: يمكنك تزويد مستطيل مرجعي صريح أو تركه فارغًا لاستخدام كامل الصورة كمرجع.
* دعم متعدد للمستطيلات: يقبل مستطيلاً واحدًا أو قائمة من المستطيلات في عملية واحدة.
* تعامل آمن: يتحقق ويبلغ عند وجود مداخل غير صالحة أو إحداثيات خارج حدود الصورة.

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

1. زوّد `Image Any` بصورة.
2. عرّف المنطقة المرجعية عبر مدخل `Rectangle` (نقطتا الزاوية). اتركه فارغًا لاستخدام كامل الصورة.
3. أدخل المستطيل/المستطيلات المرشّحة إلى مدخل `Rectangles` (مستطيل واحد أو قائمة).
4. شغّل السيناريو. افحص صورة `Result` لتعرف أي المستطيلات داخل المنطقة المرجعية واستخدم مخرجات `Not Empty`، `Count`، و`Rectangles` للمنطق أو التسجيل.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

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

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

* استخدم `Find Object` (مطابقة القالب) أو بلوكات كشف مشابهة لتوليد المستطيلات المرشّحة تلقائيًا، ثم مرّر تلك المستطيلات إلى هذا البلوك لتصفية حسب المنطقة.
* إذا احتجت طريقة تفاعلية سريعة لإنشاء المنطقة المرجعية، اجمع هذا البلوك مع `Image ROI Select` أو `Image ROI` لقص أو اختيار المنطقة بصريًا قبل تمريرها.
* للمناطق متعددة الأضلاع، فكّر باستخدام `Image ROI Polygon` أو `Check Area (Polygon)` مع هذا البلوك. استخدم بلوكات معتمدة على المضلعات لتعريفات مناطق أكثر دقة، ثم حوّل أو زوّد إحداثيات مستطيلات عند الحاجة.
* لعرض النتائج على الشاشة، ضع بعد هذا البلوك `Show Image` لفتح نافذة عرض أكبر.
* لحفظ أو أرشفة النتائج، أرسل مخرج `Result` إلى `Image Logger` أو `Image Write` لحفظ الصور المشروحة عند حدوث تطابقات.
* إذا أعاد الكشف مستطيلات غير متوقعة، قم بتمهيد الصورة باستخدام `Blur`، `Image Threshold`، أو `HSV Filter` لتحسين جودة الكشف في المراحل السابقة.

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

* إذا لم يُكتشف أي مستطيل داخل المرجع بالرغم من التداخل المرئي، تأكد أن المستطيل المرجعي والمستطيلات المرشّحة مقدمة بالتنسيق المتوقع (نقطتا زاوية لكل مستطيل) وأن الإحداثيات داخل أبعاد الصورة.
* إذا ظهرت المستطيلات الموسومة بشكل غير صحيح، تأكد أن مدخل قائمة المستطيلات يتبع التهيئة الصحيحة (قائمة أزواج الإحداثيات) وجرب استخدام `Get ROI` أو `Image ROI Select` لتوليد إحداثيات سليمة.
* إذا بدت الصورة الناتجة دون تغيير، تحقّق من أن مدخل الصورة يحتوي المحتوى المتوقع وأن إحداثيات المستطيلات ليست فارغة أو None.
* استخدم `Debug Input` أو بلوكات التسجيل لفحص قوائم المستطيلات الوسيطة إذا كانت النتائج غير متوقعة.