> 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/image-roi-polygon.md).

# Image ROI Polygon

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

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

* `Image Any`\
  الصورة المعروضة والمستخدمة للتعليل. قم بتوصيل أي بلوك يولد صورة هنا حتى تتمكن من رسم المضلع على معاينة حية.

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

* `Image Any`\
  الصورة المقتطعة التي تتوافق مع منطقة المضلع. إذا لم يتم تعريف مضلع فقد يكون هذا المخرج فارغًا.
* `Polygon`\
  إحداثيات المضلع المعادة كقائمة contour/shape مناسبة للاستخدام في بلوكات أخرى.

## 🕹️ عناصر التحكم (Controls)

* `Left Click`\
  إضافة رأس (vertex) في المكان الذي يتم النقر عليه.
* `Drag`\
  انقر واسحب رأسًا موجودًا لإعادة وضعه.
* `U`\
  التراجع عن آخر رأس تمت إضافته (Undo).
* `C`\
  مسح كل الرؤوس والبدء من جديد.
* `Overlay Preview`\
  تُعرض علامات مرئية والتعبئة أثناء التعديل حتى ترى المضلع والرؤوس ومنطقة التحديد في الوقت الفعلي.

## ⚙️ آلية التشغيل (Running mechanism)

* قم بتوصيل مصدر صورة إلى مدخل `Image Any` وشغّل السيناريو مرة واحدة لملء المعاينة.
* ارسم المضلع بالنقر لإضافة الرؤوس. يتحدّث الـ overlay فورًا.
* استخدم السحب واختصارات لوحة المفاتيح لتعديل الشكل بدقة.
* عندما يوجد مضلع، ينتج البلوك صورة مقتطعة (المستطيل المحيط الضيق للمضلع) وقائمة إحداثيات المضلع عند كل تقييم.

## ✨ الميزات (Features)

* رسم مضلع تفاعلي مع إمكانية تعديل الرؤوس.
* اختصارات التراجع/المسح لتصحيحات سريعة.
* تراكب مرئي مع إبراز الرؤوس أثناء التحويم أو السحب.
* إخراج كل من الصورة المقتطعة وإحداثيات المضلع الدقيقة.
* يدعم ROI غير مستطيلة ومتعددة النقاط للأشكال غير المنتظمة.

## 📝 نصائح الاستخدام (Usage tips)

* ارسم على الأقل ثلاث نقاط لتشكيل مضلع مملوء؛ نقاط أقل لن تُنتِج لقطة ROI صالحة.
* بعد الرسم، شغّل البلوكات اللاحقة لمعالجة الصورة المقتطعة أو إحداثيات المضلع.
* استخدم السحب لضبط مواقع الرؤوس بدقة لقياسات دقيقة.

## 💡 نصائح وحيل (Tips and Tricks)

* عاين صورًا أكبر بتوصيل المخرج إلى `Show Image` لتتمكن من الرسم بدقة على عارض منفصل.
* إذا احتجت إلى عدة ROIs في صورة واحدة، استخدم `Image ROI Polygon Multi` لتخزين عدة اختيارات مضلع ثم مرّر كلٍ منها إلى بلوكات المعالجة.
* ادمج مع `Get ROI` أو `Image ROI Select` إذا فضلت الاقتصاص المستطيلي أولًا ثم دقّق بالمضلع للأشكال المعقدة.
* استخدم `Apply Mask` بعد هذا البلوك لقناع الصورة الأصلية بالمضلع ومرّر تلك الصورة المقنعة إلى بلوكات التحليل.
* مرّر الصورة المقتطعة للمضلع إلى بلوكات الكشف أو التحليل مثل `Find Object`, `Object Detection`, `Mask Detection`, `Histogram On Line` أو `Color Density Percentage` لتركّز المعالجة على المنطقة المحددة.
* إذا كانت الصورة كبيرة جدًا للرسم بشكل مريح، أضف `Image Resizer` أو `Image Resize` قبل هذا البلوك؛ تذكّر أن تغيير الحجم يغيّر إحداثيات البكسل المستخدمة من قبل البلوكات الحساسة للهندسة.
* احفظ الـ ROIs المحددة باستخدام `Image Logger`, `Image Write` أو `Multi Image Write` لجمع مجموعات بيانات أو للمراجعة لاحقًا.

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

* لا تظهر أي صورة: تأكد من توصيل بلوك يولد صورة إلى `Image Any` وشغّل مرة واحدة لملء المعاينة.
* لم يتم إنتاج ROI: تأكد من وجود ثلاث رؤوس على الأقل؛ نقاط أقل لا تكوّن مضلعًا مملوءًا.
* يظهر المضلع في مكان خاطئ بعد تغيير حجم الصور في المسار السابق: ارسم على الدقة النهائية أو أدرج `Image Resizer` بشكل ثابت في الخط لمعالجة اتساق الإحداثيات.
* تحتاج إحداثيات دقيقة لبلوكات أخرى: استخدم مخرج `Polygon` (قائمة الإحداثيات) وتحقق عبر معاينة بواسطة `Show Image` أو أعد التشغيل بعد التعديلات.