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

# Auto Contrast

هذه الدالة تقوم تلقائياً بضبط تباين الصورة عن طريق تحليل المدرج التكراري (histogram) للصورة وتمديد قيم البكسل لتحسين الوضوح. هي مثالية لتحسين السطوع والتباين بسرعة لصور أو لقطات كاميرا دون الحاجة لتعديل المنحنيات يدوياً.

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

`Image Any` — مقبس الإدخال الذي يستقبل الصورة المراد ضبط تباينها.

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

`Image Any` — مقبس الإخراج الذي يوفر الصورة بعد تعزيز التباين.

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

`Threshold` — شريط تمرير لتعيين نسبة قص المدرج التكراري (النطاق عادةً 1–99). القيم الأعلى تقصي المزيد من القيم المتطرفة قبل التمديد، مما ينتج تبايناً أقوى.

## ⚙️ كيفية العمل <a href="#how-it-works" id="how-it-works"></a>

عند تشغيل البلوك، يحلل المدرج التكراري للصورة المدخلة للعثور على نقاط القطع الدنيا والعليا اعتماداً على قيمة `Threshold` المحددة. ثم يعيد مقياس قيم البكسل بحيث يملأ النطاق اللوني المفيد النطاق المتاح في الإخراج. النتيجة صورة أكثر سطوعاً وتبايناً بصرياً مع محاولة الحفاظ على التفاصيل داخل النطاق المقطوع.

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

* قص المدرج التكراري تلقائياً لتوسيع النطاق اللوني القابل للاستخدام.
* تحكم بشريط واحد لتعديلات سريعة وبديهية.
* يعمل مع الصور بتدرج الرمادي والصور الملونة.
* عملية سريعة مناسبة للعرض في الوقت الحقيقي والمعالجة الدفعية.

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

1. قم بربط مصدر صورة إلى مدخل `Image Any` (مثل `Camera USB`, `Camera IP (ONVIF)`, `Load Image`).
2. اضبط شريط `Threshold` للتحكم في مدى شدة قص المدرج التكراري.
3. استخدم خرج البلوك `Image Any` كمدخل إلى بلوكات العرض أو المعالجة اللاحقة (مثل `Show Image`, `Image Logger`, `Image Write`).

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

* اجمع مع `Denoising` أو `Blur` قبل تعزيز التباين لتقليل تضخيم الضوضاء في الصور شديدة الضوضاء.
* استخدم `Normalize Image` إذا احتجت استراتيجية تطبيع مختلفة أو رغبت في مطابقة التباين بصورة مرجعية.
* بعد التباين التلقائي، اضبط النتيجة بدقة مع `Contrast-Brightness-Gamma` للتحكم الأفضل في النغمات المتوسطة وgamma.
* راجع النتائج باستخدام `Show Image` أثناء الضبط، واحفظ النتائج المفضلة باستخدام `Image Write` أو `Image Logger`.
* عند التعامل مع مشاكل لونية معينة، جرّب `Adjust Colors` أو تحويل `Color Space` قبل تطبيق التباين التلقائي للحصول على توازن ألوان أفضل.

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

* المخرج يبدو قاسياً أو مقطوعاً: قلل قيمة `Threshold` للحفاظ على المزيد من الإبرازات/الظلال.
* فقدان التفاصيل في الإبرازات/الظلال: جرّب قيمة `Threshold` أقل أو اتبع ذلك بتعديلات `Contrast-Brightness-Gamma`.
* زيادة الضوضاء المرئية بعد التعزيز: طبق `Denoising` قبل التباين التلقائي، أو قلل قيمة `Threshold`.
* حدوث انحرافات لونية بعد المعالجة: جرّب تحويل `Color Space` أو استخدم `Adjust Colors` قبل التباين التلقائي.

## ✅ أفضل الممارسات <a href="#best-practices" id="best-practices"></a>

* ابدأ بقيمة `Threshold` منخفضة إلى متوسطة وزدها تدريجياً حتى تحصل على التباين المطلوب.
* استخدم `Show Image` للمقارنة بين قبل/بعد في الوقت الفعلي.
* في خطوط الأنابيب الآلية، اختبر إعدادات العتبة على مجموعة ممثلة من الصور لتجنب المعالجة الزائدة أو الناقصة.