> 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-optimization.md).

# Contrast Optimization

هذا البلوك يقوم بتحسين التباين المحلي للصور باستخدام تقنية التسوية التكيفية للهستوجرام مع حد للتباين (contrast-limited adaptive histogram equalization). يكون مفيدًا عندما تكون التفاصيل مخفية في مناطق ذات سطوع متشابه وتريد إظهار تلك التفاصيل دون تضخيم الضوضاء بشكل مفرط.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Image Any` الصورة الداخلة التي سيتم تحسين تباينها. يعمل مع الصور الملونة أو الرمادية.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Image Any` صورة الإخراج المحسّنة بالتباين.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Grid Size` يضبط حجم الشبكة المحلية المستخدمة لتسوية التباين. القيم الأكبر تنتج بلاطات أكبر وتعديلات تباين محلية أكثر خشونة.

`Clip Limit` يتحكم في مدى تقييد التباين لتجنب تضخيم الضوضاء. القيم الأعلى تزيد من مقدار تعزيز التباين.

## 🎨 الميزات <a href="#features" id="features"></a>

* يعزز التفاصيل المحلية في الظلال والمناطق المضيئة مع منع تضخيم الضوضاء بشدة.
* يعمل على الصور الملونة عن طريق تطبيق التحسين على قناة الإضاءة (lightness) مع الحفاظ على الألوان.
* مزالق تفاعلية تتيح ضبط البلوك في الوقت الفعلي لمشهدك.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. اربط مصدر الصورة إلى مدخل `Image Any`.
2. اضبط `Grid Size` للتحكم بمقياس رقع التباين المحلية.
3. اضبط `Clip Limit` للتحكم في قوة التحسين.
4. راجع النتيجة من مخرج `Image Any` وقم بضبط المزالق حسب الحاجة.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التشغيل، يعالج هذا البلوك الصورة الواردة وينتج صورة مُحسّنة تكشف فروق التباين المحلية مع المحافظة على مستوى ضوضاء مقبول.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* للصور كبيرة جدًا، استخدم `Image Resizer` لتقليل حجم الإدخال قبل تشغيل هذا البلوك لسرعة المعالجة.
* إذا بدت النتيجة مزعجة الضوضاء، جرّب `Denoising` قبل تطبيق هذا البلوك ثم قارن بالنتيجة الأصلية.
* لمعاينة النتائج أثناء بناء التدفق، ربط الإخراج بـ `Show Image`.
* إذا كنت تحتاج لتحسين منطقة محددة فقط، قم أولًا بقصها باستخدام `Image ROI` ثم طبق هذا البلوك.
* امزج مع `Auto Contrast` أو `Normalize Image` للمقارنة بين التحسين العالمي والمحلي واختيار الأفضل لتطبيقك.
* احفظ الصور النهائية باستخدام `Image Write` أو سجّل نتائج متعددة بـ `Image Logger`.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا بدت الصور مشبعةً جدًا أو صاخبة، خفّض قيمة `Clip Limit` أو قم بمرحلة معالجة مسبقة باستخدام `Denoising`.
* إذا اختفت التفاصيل الصغيرة جدًا، زد `Grid Size` لتفادي تعديلات محلية مفرطة.
* إذا كانت المعالجة بطيئة، قلل حجم الصورة باستخدام `Image Resizer` قبل إدخالها إلى هذا البلوك.