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

# Image ROI Polygon Multi

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

## 📥 المدخلات

`Image Any`\
قدّم الصورة التي تريد تعليقها (annotate). بمجرد توصيل صورة وتشغيل البلوك، تصبح الصورة قماش الرسم للرسم والتعديل على المضلعات.

## 📤 المخرجات

`Highlighted Image`\
تعيد الصورة الأصلية مع المضلعات المطبقة كطبقات توضيحية (المحفوظة والحالية) وعلامات مرئية.

`Polygon Images`\
تعيد قائمة بالصور المقتطعة والمقنّعة — صورة لكل مضلع محفوظ — مع الحفاظ على بكسلات المنطقة داخل كل مضلع.

`Polygons`\
تعيد قائمة بشكل المضلعات على هيئة قوائم إحداثيات (contours) قابلة للاستخدام في بلوكات دوال أخرى.

## 🕹️ الضوابط (Controls)

`Draw Polygon Canvas`\
منطقة تفاعلية على الصورة حيث ترسم المضلعات بنقرات الفأرة اليسرى.

`Press C`\
يمسح المضلع الحالي (أو يزيل آخر مضلع محفوظ إذا لم يكن هناك مضلع حالي).

`Press U`\
يتراجع عن النقطة الأخيرة للمضلع الحالي. إذا لم يوجد مضلع حالي، فسيعيد آخر مضلع محفوظ إلى وضع التحرير.

`Press S`\
يحفظ المضلع الحالي (يتطلب على الأقل 3 نقاط). تصبح المضلعات المحفوظة جزءًا من قوائم المخرجات.

تفاعلات الفأرة: النقر الأيسر لإضافة نقطة؛ السحب على رأس نقطة لتحريكها؛ التوجيه فوق الرؤوس لإبرازها وتمكين التحرير. يتغير شكل مؤشر الفأرة ليشير إلى وضع الإنشاء أو تحرير الرؤوس.

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

* تحرير متعدد المضلعات مستمر: أنشئ عدة مضلعات والتنقل بين المضلع الحالي والمحفوظين.
* طبقات توضيحية مرئية: ألوان مختلفة تشير للمضلعات المحفوظة، المضلع الجاري تحريره، الرؤوس المظللة، والنقاط النشطة.
* قص ROI قابل للتصدير: يعيد صورًا مقتطعة ومقنّعة لكل مضلع محفوظ صالحة للمعالجة الإضافية.
* تصدير الإحداثيات: يعيد إحداثيات رؤوس المضلعات كقوائم contour قياسية للاستخدام اللاحق.
* اختصارات لوحة مفاتيح بسيطة للتحرير السريع (C, U, S) ورسم بديهي بالماوس.

## ⚙️ كيفية التشغيل (How it runs)

* عند توصيل صورة إلى المدخل وتشغيل البلوك، تظهر الصورة في قماش الرسم التفاعلي.
* ارسم نقاطًا على القماش لتشكيل مضلع. تتحدّث الطبقات التوضيحية في الوقت الفعلي.
* يؤدي حفظ المضلع إلى إضافته إلى القائمة الداخلية؛ يقوم البلوك بتحديث المخرجات في كل تشغيل: الصورة المشروحة، قائمة الصور المقتطعة/المقنعة للمضلعات، وقائمة إحداثيات المضلعات.
* يؤدي تحرير رؤوس النقاط وسحبها إلى تحديث المخرجات عند التقييم التالي.

## 📝 تعليمات الاستخدام (Usage Instructions)

1. صِل مصدر صورة إلى مدخل `Image Any` (على سبيل المثال: `Camera USB`، `Load Image`، أو `Stream Reader`).
2. انقر على القماش لإضافة رؤوس المضلع. أضف ثلاث نقاط على الأقل لتكوين مضلع.
3. استخدم `Press S` لحفظ المضلع الحالي. ستُضمّن المضلعات المحفوظة في المخرجات.
4. لتصحيح نقطة، حرّك المؤشر حتى يبرز الرأس ثم اسحبه إلى الموضع الجديد.
5. استخدم `Press U` للتراجع عن النقطة الأخيرة، أو `Press C` لمسح المضلع الحالي.
6. شغّل البلوك للحصول على مخرجات `Highlighted Image` و`Polygon Images` و`Polygons` لتمريرها إلى بلوكات أخرى.

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

* اختر مسبقًا مناطق الاهتمام باستخدام `Image ROI Select` أو `Image ROI` عندما تحتاج فقط للتركيز على منطقة فرعية قبل رسم المضلعات.
* استخدم `Apply Mask` بعد هذا البلوك لدمج أقنعة المضلعات مع منطق قناع آخر (مثلًا لإزالة الخلفية أو دمج أقنعة متعددة).
* مرّر `Polygon Images` إلى بلوكات التحليل أو الكشف مثل `Find Object`، `Object Detection`، أو `Mask Detection` لتشغيل الكشف داخل المناطق المحددة فقط.
* احفظ أمثلة من ROIs المقتطعة باستخدام `Image Logger` أو `Image Write` لبناء مجموعة بيانات مرجعية من المضلعات المختارة.
* لعرض تراكبات متعددة محفوظة جنبًا إلى جنب، استخدم `Image Concatenate` أو `Collage Images` مع خرج `Polygon Images`.
* للمعالجة المسبقة قبل الرسم (مثلاً لإنشاء قناع ثنائي تريد تتبعه)، استخدم `Blur`، `Image Threshold`، أو `HSV Filter` في المسار السابق لتبسيط الحدود.

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

* لا يحدث شيء عند النقر على القماش: تأكد من توصيل صورة إلى `Image Any` وتشغيل البلوك مرة حتى يتم تهيئة القماش.
* لا يمكن حفظ المضلع: تحقق أن المضلع الحالي يحتوي على ثلاث نقاط على الأقل قبل الضغط على `Press S`.
* مخرجات المضلعات فارغة: تأكد من حفظ المضلعات (باستخدام `Press S`) وليس إبقائها كحالٍ فقط؛ المضلعات غير المحفوظة غير مدرجة في `Polygon Images` أو `Polygons`.
* المقطع المقتطع للمضلع يبدو فارغًا: تأكد أن المضلع داخل حدود الصورة وأن الصورة تحتوي على بيانات بكسل صالحة. عند الحاجة، قم بعمل معالجة مسبقة مثل `Normalize Image` أو `Denoising` قبل الرسم.