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

# Check Area

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

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

`Image Any` صورة المرجع التي تُستخدم كقماش للإحداثيات حيث ترسم المنطقة المستطيلة.

`Position Coordinate(s)` نقطة واحدة أو قائمة نقاط للاختبار مقابل المنطقة المحددة. قدّم إحداثيات البيكسل (x, y).

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

`Area Rectangle` المستطيل الذي اخترته، معبرًا عنه بإحداثيات بيكسل الصورة.

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

`Detection Count` عدد النقاط المدخلة التي وُجدت داخل المستطيل المحدد.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Image Preview` انقر واسحب مباشرةً على المعاينة لرسم منطقة مستطيلة. ستعرض المعاينة تغطية المستطيل في الوقت الحقيقي.

`Drag to Select` استخدم حركة النقر والسحب لتعيين الزاوية العلوية اليسرى والزاوية السفلية اليمنى للمستطيل. إعادة الرسم تحدّث المنطقة المحددة فورًا.

`Overlay Display` تظهر علامات مرئية على الصورة للمستطيل المحدد ولأي نقاط تقع بداخله.

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

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

## 📊 كيفية العمل <a href="#evaluation" id="evaluation"></a>

* قدّم صورة صالحة إلى مدخل `Image Any` ليصبح المعاينة التفاعلية نشطة.
* ارسم المستطيل مباشرةً على المعاينة باستخدام النقر والسحب. تُفسَّر المنطقة المحددة بإحداثيات بيكسل الصورة.
* أدخل النقاط إلى `Position Coordinate(s)` (نقطة مفردة أو قائمة). عند التشغيل، يتحقق البلوك من كل نقطة مقابل المستطيل المحدد ويعيد المستطيل، وما إذا كانت هناك نقاط بداخله، وعددها. تُحدَّث المعاينة لعرض المستطيل وأي نقاط داخلية.

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

1. وصل مصدر صورة إلى `Image Any` حتى تظهر المعاينة التفاعلية.
2. انقر واسحب على المعاينة لرسم المنطقة التي تريد مراقبتها.
3. زوّد إحداثيات النقاط إلى `Position Coordinate(s)` (مثلاً مخرجات من بلوك كشف).
4. شغّل السيناريو؛ تظهر النتائج كـ `Area Rectangle`, `Object In Area`, و `Detection Count`. تعرض المعاينة علامات لأي نقاط داخل المستطيل.

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

* للحصول على إحداثيات النقاط من الكواشف الآلية، وصل المخرجات من بلوكات مثل `Find Object` أو `Object Detection` (أو `Object Detection - Custom`) إلى مدخل `Position Coordinate(s)`.
* إذا احتجت لمناطق اقتصاص متعددة أو أشكال ROI أكثر مرونة، فكّر باستخدام `Image ROI Select` أو `Image ROI Polygon Multi` ثم وجّه النتائج إلى بلوكات تصفية متخصصة.
* استخدم `Draw Rectangle` أو `Draw Point` لإنشاء مخرجات بصرية مدمجة للتقارير أو العروض بعد الفحص.
* للتصفية على مستوى أعلى (مثلاً مقارنة مستطيل واحد بعدة مستطيلات مكتشفة)، اجمع مع `Rectangles in Rectangle` لتحسين النتائج.
* إذا كانت الإحداثيات تأتي من كواشف وضعية أو نقاط مفاتيح، جرب المزج مع `Pose Estimation` أو `Hand Pose Estimation` للتحقق من نقاط مفاتيح جسم أو اليد داخل المنطقة.

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

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