> 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/check-area-polygon.md).

# Check Area (Polygon)

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

## 📥 المدخلات (sockets)

`Input Image (Binary Image)`\
الصورة التي سترسم فوقها المضلع وتعرض عليها الملاحظات البصرية.

`Position Coordinate List`\
قائمة إحداثيات نقاط (x, y) ليتم اختبارها مقابل المضلع المرسوم. تدعم عدة مواضع.

## 📤 المخرجات (sockets)

`Output Image`\
الصورة مع المنطقة المضلّعة المظللة والمواضع المكتشفة المعلّمة.

`Polygon Coordinates`\
رؤوس المضلع كشكل يمكن استخدامه بواسطة كتل أخرى.

`Object In Area`\
قيمة منطقية (Boolean) تشير إلى ما إذا كانت أي من المواضع المقدمة داخل المضلع.

`Detected Positions`\
قائمة المواضع التي وُجدت داخل المضلع.

## 🕹️ الضوابط (widgets & interactions)

`Image Canvas`\
انقر على الصورة لإضافة نقاط المضلع. يعرض المضلع المرسوم فوق الصورة في الوقت الحقيقي.

`U`\
اضغط هذا المفتاح للتراجع عن آخر نقطة أُضيفت.

`C`\
اضغط هذا المفتاح لمسح كل نقاط المضلع والبدء من جديد.

`Select Area`\
استخدم التفاعل الرسم لإنشاء منطقة المضلع المطلوبة.

## 🎨 الميزات

* رسم مضلع بصري فوق الصورة المدخلة مع معاينة مستمرة.
* تظليل فوري للمنطقة المحددة بتراكب شفاف.
* وسم المواضع المكتشفة داخل المضلع بعلامات واضحة.
* إرجاع إحداثيات المضلع كشكل قابل لإعادة الاستخدام في كتل معالجة أخرى.
* دعم عدة مواضع إدخال والإبلاغ عما هو داخل المنطقة المرسومة.

## ⚙️ آلية التشغيل

* تُعرض الصورة المرسلة إلى `Input Image (Binary Image)` على اللوحة (canvas).
* تضيف رؤوس المضلع تفاعليًا بالنقر على اللوحة؛ كل نقرة تصبح رأسًا.
* يُعرض المضلع المرسوم مع تمييز بصري على الصورة.
* عندما تُزود `Position Coordinate List` بإحداثيات، تتحقق الكتلة من كل نقطة وتعلم النقاط الموجودة داخل المضلع.
* تُخرج النتائج (الصورة المظللة، إحداثيات المضلع، العلم المنطقي والمواضع المكتشفة) ليتمكن بلوكات أخرى من استهلاكها.

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

1. وصل صورة إلى `Input Image (Binary Image)` لتمكين اللوحة الرسمية.
2. انقر على الصورة لإضافة رؤوس المضلع بترتيب عقارب الساعة أو عكسها.
3. استخدم `U` للتراجع عن نقطة أو `C` للمسح وإعادة الرسم.
4. أمدّ `Position Coordinate List` بقائمة إحداثيات للتحقق من النقاط الموجودة داخل المضلع.
5. استخدم مخرج `Polygon Coordinates` لتمرير المنطقة المرسومة إلى كتل أخرى للمعالجة التالية.

## 💡 نصائح وحيل

* لإمداد النقاط للاختبار تلقائيًا، استخدم `Find Object` أو `Object Detection` (أو `Object Detection - Custom`) في المسار السابق بحيث تُمرّر مراكز الكائنات المكتشفة إلى مدخل `Position Coordinate List`.
* لعرض النتائج في نافذة أكبر، وصل `Output Image` إلى `Show Image` لمعاينة موسّعة.
* احفظ أو سجّل الصور المظللة بربط `Output Image` إلى `Image Logger` أو `Image Write`.
* لإنشاء عدة مناطق ROI، اجمع هذه الكتلة مع `Image ROI Polygon Multi` لإدارة عدة مضلعات وتمرير إحداثيات المضلع المختار لاحقًا.
* إذا أردت وسم الاكتشافات بمستطيلات بدل النقاط، استخدم `Draw Rectangle` أو `Draw Point` لاحقًا مع الإحداثيات الموفرة من هذه الكتلة.
* في سيناريوهات التتبع، مرّر الاكتشافات من `Object Detection` إلى `Object_Detection_Tracker` واستخدم هذه الكتلة للتحقق من أحداث الدخول/الخروج داخل منطقة مضلعية.

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

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