> 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) وأن الإحداثيات ضمن نفس إطار المرجع المعروض بالصورة.
* إذا اختفى المضلع بين الجلسات، أعد رسمه أو خزّن مخرج المضلع إلى كتلة تخزين دائمة (مثل ملفات أو سجلات) وأعد استخدامه عند الحاجة.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/detections-shapes/roi-processing/check-area-polygon.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.