> 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/image-transformations/transformation-filters/floodfill.md).

# FloodFill

هذه الدالة تملأ المناطق المغلقة في الصورة ابتداءً من نقطة بذرة (seed point) بناءً على تشابه الألوان. تعمل مع الصور الرمادية أو الملونة وتوفر منزلقًا بسيطًا للتحكم بمدى سماحية الملء.

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

`Input Image` الصورة المصدر التي سيتم تطبيق الملء عليها (رمادية أو ملونة).

`Seed Point (X,Y)` اختياري. إحداثية البداية لعملية الملء. إذا لم تُعطَ، سيستخدم البلوك مركز الصورة.

`Fill Color (R,G,B)` اختياري. اللون المستخدم لملء المنطقة المحددة. إذا تُرك فارغًا، يُستخدم لون افتراضي أخضر.

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

`Image` الصورة الناتجة بعد تطبيق منطقة الملء.

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

`Fill Range` منزلق أفقي لتحديد نطاق التسامح الأدنى والأعلى لفروق الألوان. زيادة النطاق يجعل الملء يقبل اختلافات لونية أكبر حول البذرة؛ تقليله يقيّد الملء بالبكسلات الأكثر تشابهًا مع البذرة.

## 🎯 الميزات

* يعمل مع المدخلات الرمادية والملونة — الصور الرمادية تُعالَج تلقائيًا حتى يمكن استخدام البلوك في أيتا الحالتين.
* نقطة البذرة ولون الملء اختياريان، مما يتيح استخدام تفاعلي سريع أو خطوط معالجة مؤتمتة بالكامل.
* المخرج المرئي يتضمن المنطقة المملوءة معروضة فوق الصورة الأصلية لسهولة معاينة النتائج فورًا.
* تحكم بسيط بمنزلق واحد لضبط مدى نمو المنطقة بدقة.

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

عند تشغيل البلوك:

* يستخدم نقطة البذرة المقدمة لبدء ملء المنطقة. إذا لم تُزوّد بذرة، يستخدم مركز الصورة افتراضيًا.
* يستخدم قيم `Fill Range` لتحديد البكسلات المجاورة التي تُعتبر متشابهة بما يكفي لتشملها عملية الملء.
* يطبّق لون الملء المختار (أو اللون الافتراضي) على المنطقة المحددة ويخرج الصورة المعدّلة.

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

1. وصل الصورة إلى `Input Image`.
2. اختياريًا قدّم `Seed Point (X,Y)` لاستهداف منطقة محددة؛ وإلا اتركه ليأخذ المركز.
3. اختياريًا قدّم `Fill Color (R,G,B)` لاختيار لون الملء، أو اتركه فارغًا للون الافتراضي.
4. عدّل `Fill Range` حتى تتطابق المنطقة المملوءة مع توقعاتك.
5. عاين النتيجة من مخرج `Image`.

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

* استخدم `Blur` قبل هذا البلوك لتنعيم الضوضاء حتى لا تقطع التباينات الصغيرة نمو الملء.
* استخدم `Image Threshold` أو `HSV Filter` لعزل المنطقة المستهدفة أولًا — هذا قد يجعل نتائج الملء أكثر موثوقية على الخلفيات الملوّنة أو المزعجة.
* اقتطع منطقة الاهتمام باستخدام `Image ROI Select` أو `Image ROI` قبل الملء لتقليل العمليات وتسريع المعالجة.
* بعد الملء، عاين النتائج بـ `Show Image` واحفظها بـ `Image Write` أو `Image Logger` عند الحاجة.
* إذا امتد الملء أكثر من اللازم، قلّل التسامح عبر `Fill Range`. إذا لم يغطي المنطقة كاملة، زد التسامح.
* للأهداف اللونية، جرّب تحويل أو عزل الألوان باستخدام `HSV Filter` ثم أدخل النتيجة إلى هذا البلوك للحصول على ملء أكثر اتساقًا.

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

* لا تغيير مرئي: تحقق من موضع نقطة البذرة وتأكد أن المنطقة المستهدفة داخل حدود الصورة؛ عاين الإدخال باستخدام `Show Image`.
* تسرب الملء إلى مناطق غير مرغوبة: خفّض تسامح `Fill Range` أو عالِج مسبقًا بـ `Image Threshold`/`Blur` لتقليل الألوان المشابهة خارج المنطقة المقصودة.
* نتيجة لونية غير متوقعة: تحقق من قيم `Fill Color (R,G,B)` وعاين اللون على صورة عيّنة قبل تشغيل المسار الكامل.