Rectangles in Rectangle

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

📥 المداخل

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

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

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

📤 المخرجات

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

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

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

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

🕹️ الضوابط

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

🎨 الميزات

• تأكيد بصري: تُظهر الصورة الناتجة بوضوح المنطقة المرجعية وتُرسم كل مستطيل مرشّح مع حالة ملونة وتسميات نصية.

• مرجع مرن: يمكنك تزويد مستطيل مرجعي صريح أو تركه فارغًا لاستخدام كامل الصورة كمرجع.

• دعم متعدد للمستطيلات: يقبل مستطيلاً واحدًا أو قائمة من المستطيلات في عملية واحدة.

• تعامل آمن: يتحقق ويبلغ عند وجود مداخل غير صالحة أو إحداثيات خارج حدود الصورة.

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

1. زوّد Image Any بصورة.

2. عرّف المنطقة المرجعية عبر مدخل Rectangle (نقطتا الزاوية). اتركه فارغًا لاستخدام كامل الصورة.

3. أدخل المستطيل/المستطيلات المرشّحة إلى مدخل Rectangles (مستطيل واحد أو قائمة).

4. شغّل السيناريو. افحص صورة Result لتعرف أي المستطيلات داخل المنطقة المرجعية واستخدم مخرجات Not Empty، Count، وRectangles للمنطق أو التسجيل.

📊 التقييم

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

💡 نصائح وحيل

• استخدم 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 لتحسين جودة الكشف في المراحل السابقة.

🛠️ استكشاف الأخطاء وإصلاحها

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

• إذا ظهرت المستطيلات الموسومة بشكل غير صحيح، تأكد أن مدخل قائمة المستطيلات يتبع التهيئة الصحيحة (قائمة أزواج الإحداثيات) وجرب استخدام Get ROI أو Image ROI Select لتوليد إحداثيات سليمة.

• إذا بدت الصورة الناتجة دون تغيير، تحقّق من أن مدخل الصورة يحتوي المحتوى المتوقع وأن إحداثيات المستطيلات ليست فارغة أو None.

• استخدم Debug Input أو بلوكات التسجيل لفحص قوائم المستطيلات الوسيطة إذا كانت النتائج غير متوقعة.