> 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/shape-analysis/fill-contour.md).

# Fill Contour

تقوم هذه الوحدة الوظيفية بتعبئة منطقة محددة بمخطط (contour) على صورة الإدخال. استخدمها لقناع مناطق معينة أو للاحتفاظ بمناطق محددة بواسطة المخطط — إما بتعبئة داخل الشكل أو بالاحتفاظ بكل شيء خارجها.

## 📥 المدخلات

* `Image Any` — الصورة المصدرية التي سيتم تطبيق المخطط عليها.
* `Contour` — قائمة نقاط المخطط أو تعريف مستطيل بسيط بنقطتين.

## 📤 المخرجات

* `Output Image` — الصورة الناتجة مع منطقة المخطط المعبأة أو العكس، بحسب إعدادات عناصر التحكم.

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

* `Fill Inside` — خانة اختيار. عند تفعيلها يُحتفظ بالمنطقة داخل المخطط (ويزال كل ما عداها). عند إيقافها يُحتفظ بالخارج ويُزال الداخل.

## 🎯 الميزات

* يقبل مخططات معقدة وكذلك تعريف مستطيل بسيط بنقطتين لأقنعة مستطيلة سريعة.
* يتيح اختيار الاحتفاظ بالداخل أو الخارج للمخطط.
* ينتج مخرجات نظيفة مناسبة للمعالجة اللاحقة أو للعرض.

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

عند التشغيل، تقرأ الوحدة الصورة ونقاط المخطط المقدمة. إذا تم تزويد نقطتين فقط، فسيتم تفسيرهما كزاويتين متقابلتين لمستطيل. ثم تُنشئ الوحدة قناعًا من المخطط وتطبقه على صورة الإدخال، فتنتج النتيجة المعبأة/المفلترة وفقًا لخيار `Fill Inside`.

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

1. زود `Image Any` بصورة.
2. زود `Contour` بنقاط المخطط (قائمة نقاط أو نقطتان للمستطيل).
3. قم بتبديل `Fill Inside` بناءً على ما إذا كنت تريد الاحتفاظ بمنطقة المخطط أم بمنطقتها المكملة.
4. استخدم `Output Image` للعرض أو قم بتمريرها إلى وحدات لاحقة للمعالجة.

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

* للحصول على نقاط المخطط تلقائيًا من صورة، استخدم `Find Contour` أو `Feature Detector` قبل هذه الوحدة ومرّر النتيجة إلى `Contour`.
* للاختيار اليدوي السريع لمنطقة، زوجها مع `Image ROI Select` أو `Image ROI Polygon` لتحديد المنطقة ثم استخدم الإحداثيات الناتجة هنا.
* إذا رغبت في اقتصاص المنطقة المعبأة لاحقًا، اربط الناتج بـ `Get ROI` أو `Contour to Image`.
* لسير عمل إزالة الخلفية، اجمع `Fill Contour` مع `Apply Mask` أو `Background Removal (RMBG-1.4)` حسب حاجتك.
* عاين النتيجة باستخدام `Show Image` للتحقق بصريًا قبل المتابعة.
* استخدم `Blur` أو `Image Threshold` قبل استخراج المخطط لتقليل الضوضاء وتحسين جودة المخططات.

## 🛠️ استكشاف الأخطاء

* إذا لم يحدث تغيير، تأكد أن `Contour` يحتوي نقاطًا صحيحة. تُعامل النقطتان كمساحة مستطيلة؛ وتُعرّف نقاط أكثر مضلعًا.
* إذا بدا أن المنطقة المعبأة معكوسة، قم بتبديل خانة `Fill Inside`.
* إذا تضمن الناتج مناطق غير متوقعة، جرّب المعالجة المسبقة بـ `Image Threshold` أو `Blur` ثم إعادة استخراج المخطط عبر `Find Contour`.
