> 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)` وعاين اللون على صورة عيّنة قبل تشغيل المسار الكامل.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/image-transformations/transformation-filters/floodfill.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.