> 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/contrast-brightness-gamma.md).

# Contrast-Brightness-Gamma

تتيح لك هذه دالة البلوك ضبط التباين العام والسطوع وقيمة الجاما للصورة باستخدام ثلاثة أشرطة تمرير بسيطة. مفيد لضبط العرض السريع أو كخطوة تجهيز مسبق قبل أي تحليل إضافي.

## 📥 Inputs (sockets)

* `Image Any` الصورة الواردة التي تريد تعديلها.

## 📤 Outputs (sockets)

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

## 🕹️ Controls

* `Contrast Value` شريط تمرير لزيادة أو تقليل التباين.
* `Brightness Value` شريط تمرير لرفع أو خفض سطوع الصورة.
* `Gamma Value` شريط تمرير لتطبيق تصحيح الجاما لضبط الدرجات المتوسطة دون التأثير الكبير على القيم القصوى أو الدنيا.

## 🎨 Features

* ضبط مرئي فوري عبر أشرطة التمرير لتجارب سريعة.
* عمليات مركبة: يتم تطبيق التباين والسطوع أولاً، ثم تصحيح الجاما للتحكم السلس في النغمات.
* يعمل مع أي صيغة صورة يدعمها النظام (ملونة أو تدرج رمادي).

## 📝 Usage Instructions

1. قم بتوصيل الصورة إلى مقبس الإدخال `Image Any`.
2. حرِّك شريط `Contrast Value` لضبط التباين. القيم الموجبة تزيد التباين، والسالبة تخففه.
3. حرِّك شريط `Brightness Value` لتفتيح أو تغميق الصورة.
4. عدّل شريط `Gamma Value` لتصحيح الدرجات المتوسطة دون تغيير متطرف للنقاط الساطعة أو الداكنة.
5. ستجد الصورة المعالجة على مخرج `Image Any` لعرضها أو استخدامها في بلوكات لاحقة.

## 📊 Evaluation

عند تشغيل البلوك، ينتج صورة واحدة معدلة تعكس مواضع أشرطة التمرير الحالية. استخدم هذه الصورة لإرسالها إلى تحليل لاحق أو عرض أو تخزين.

## 💡 Tips and Tricks

* للصور المشوشة، استخدم بلوك `Denoising` قبل هذا البلوك حتى لا يتم تضخيم الضوضاء عند زيادة التباين.
* إذا رغبت بتحسين تلقائي أولي، جرّب الجمع مع `Auto Contrast` للحصول على قاعدة سريعة قبل الضبط اليدوي.
* لتسريع المعالجة على صور كبيرة جداً، ضع `Image Resizer` قبل هذا البلوك لتقليل دقة الصورة.
* استخدم `Show Image` بعد هذا البلوك لمعاينة النتائج في نافذة عرض أكبر.
* لحفظ النتائج كسجل أو لوج، وصل المخرج إلى `Image Logger` أو `Image Write`.
* كمصادر صور شائعة استخدم `Load Image` أو `Camera USB` أو `Camera IP (ONVIF)` حسب سير عملك.

## 🛠️ Troubleshooting

* إذا بدت الصورة مفرطة التباين أو مقطوعة (clipped)، خفّض قيمة `Contrast Value` أو قلّل `Brightness Value` واستخدم ضبط جاما معتدل.
* إذا ظهرت ألوان غريبة بعد تعديلات قوية، جرّب `Auto Contrast` أو `Normalize Image` لإعادة توازن نطاق البكسل.
* إذا كان الاستجابة الزمنية بطيئة، قلّل دقة الصورة الداخلة باستخدام `Image Resizer` قبل الضبط.