# HSV Filter

يُتيح لك هذا البلوك عزل الألوان في الصورة عن طريق ضبط نطاقات Hue وSaturation وValue. استخدمه لإنشاء أقنعة لونية، استخراج مناطق ملونة، أو دمج المقدّمة والخلفية لأغراض العرض.

## 📥 المدخلات

هذا البلوك يحتوي على المقبس الإدخالي التالي:

* `Image Any` مقبس إدخال يقبل الصورة المطلوب معالجتها.

## 📤 المخرجات

هذا البلوك يوفر مآخذ المخرجات التالية:

* `Result Image` الصورة المُرشَّحة التي تُظهر فقط البكسلات ضمن نطاقات HSV المحددة (المقدّمة).
* `HSV Image` تمثيل الصورة المحوّل إلى فضاء اللون HSV.
* `Masked Image` قناع ثنائي/رمادي بقناة واحدة يبيّن البكسلات التي نجحت في اختبار HSV.
* `Added Image` المقدّمة مدموجة مع الخلفية لعرض أسهل.
* `Background Image` الجزء الخلفي (رمادي) حيث تمت إزالة البكسلات المقنعة.

## 🕹️ الضوابط

* `Hue (Min-Max)` زوج منزلقات لتعيين الحد الأدنى والحد الأقصى للـ Hue.
* `Saturation (Min-Max)` زوج منزلقات لتعيين الحد الأدنى والحد الأقصى للتشبع.
* `Value (Min-Max)` زوج منزلقات لتعيين الحد الأدنى والحد الأقصى للسطوع (Value).

اضبط هذه المنزلقات حتى يبرز `Masked Image` نطاق اللون المستهدف مع استبعاد المناطق غير المرغوبة.

## 🎯 الميزات

* اختيار لوني بصري وتفاعلي باستخدام ثلاثة منزلقات نطاق.
* معاينة مباشرة للقناع للتحقق السريع من النطاقات المختارة.
* مخرجات تشمل القناع والمرئيات بحيث يمكنك استخدام أيٍّ منهما للتحليل أو للمعالجة التالية.
* دمج المقدّمة المقنّعة مع خلفية رمادية للمساعدة في التحقق من المناطق المستخرجة.

## 📝 كيفية الاستخدام

1. قم بتوصيل بلوك مُنتج صورة إلى مدخل `Image Any`.
2. حرّك منزلقات `Hue (Min-Max)`, `Saturation (Min-Max)` و `Value (Min-Max)` لعزل اللون المطلوب.
3. تحقق من `Masked Image` للتأكّد من التحديد.
4. استخدم `Result Image` أو `Added Image` للمخرجات المرئية، واستخدم `Masked Image` للمعالجة أو القياسات اللاحقة.

## ⚙️ ماذا يحدث عند التشغيل

عند التشغيل، يقوم البلوك بتحويل الصورة الداخلة إلى فضاء HSV، ثم يبني قناعًا ثنائيًا باستخدام نطاقات المنزلقات، وينتج صورة ملونة مقنّعة (المقدّمة)، وخلفية رمادية، ومرئي مدمج للتحقق بسهولة.

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

* قم بالتمهيد لتقليل الضوضاء: مرّر الصورة من خلال `Blur` قبل هذا البلوك للحصول على أقنعة أنظف.
* فصل أفضل للصور الكبيرة: استخدم `Image Resize` لتقليل حجم الصورة لتسريع الضبط التفاعلي، ثم عالج الصورة بالحجم الكامل بعد الانتهاء من الإعدادات.
* ركّز على منطقة الاهتمام: قم بقص الإدخال بواسطة `Image ROI Select` قبل تطبيق HSV لتجنّب تداخل الألوان من المناطق المحيطة.
* تحسين القناع: دمج `Masked Image` مع `Apply Mask` لتصفية صورة أخرى، أو مرّرها إلى `Image Threshold` لتنظيف ثنائي إضافي.
* فحص بصري: وصل المخرج إلى `Show Image` لفتح عارض الصورة وفحص النتائج في نافذة أكبر.
* حفظ النتائج: استخدم `Image Logger` أو `Image Write` لحفظ الصور المقنّعة أو المرئيات بعد الحصول على الإعدادات المطلوبة.
* استخدام مع كاشفات: بعد عزل منطقة لونية، مرّر الصورة المقنّعة أو `Result Image` إلى كتل كشف مثل `Find Object` أو `Blob Detector` لتحديد ميزات مطابقة للون المحدد.
* تحليل الخلفية: ادمج مع `Background Subtractor` عند العمل على تدفقات فيديو لفصل الأجسام الملونة المتحركة عن الخلفيات الثابتة.

## 🛠️ استكشاف المشاكل وإصلاحها

* قناع صغير أو معدوم: تأكّد أن المنزلقات تغطي نطاق الـ Hue الصحيح للون المستهدف وأن الصورة مُلتقطة بإضاءة مناسبة.
* قناع واسع جدًا: ضيّق نطاقات `Saturation (Min-Max)` و`Value (Min-Max)` لاستبعاد الألوان المشابهة أو الانعكاسات.
* ضوضاء زائدة في القناع: أضف `Blur` أو شغّل `Image Threshold` / عمليات مورفولوجية بعد القناع لإزالة البقع الصغيرة.
* مشاكل أداء: غيّر حجم الصورة باستخدام `Image Resize` أثناء الضبط التفاعلي؛ ثم طبّق الإعدادات على الدقة الكاملة عند الانتهاء.

إذا أردت إرشادًا مخصصًا لتجميع الكتل لمهمة معيّنة، وصِف السيناريو (نوع الكاميرا، لون الهدف، وقت حقيقي مقابل وضع غير متصل) وسأقترح تركيبات مناسبة.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/arabic/function-blocks/image-transformations/color-filters/hsv-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.