Auto Contrast

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

📥 المدخلات (sockets)

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

📤 المخرجات (sockets)

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

🕹️ عناصر التحكم (widgets)

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

⚙️ كيفية العمل

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

🎨 الميزات

• قص المدرج التكراري تلقائياً لتوسيع النطاق اللوني القابل للاستخدام.

• تحكم بشريط واحد لتعديلات سريعة وبديهية.

• يعمل مع الصور بتدرج الرمادي والصور الملونة.

• عملية سريعة مناسبة للعرض في الوقت الحقيقي والمعالجة الدفعية.

📝 الاستخدام

1. قم بربط مصدر صورة إلى مدخل Image Any (مثل Camera USB, Camera IP (ONVIF), Load Image).

2. اضبط شريط Threshold للتحكم في مدى شدة قص المدرج التكراري.

3. استخدم خرج البلوك Image Any كمدخل إلى بلوكات العرض أو المعالجة اللاحقة (مثل Show Image, Image Logger, Image Write).

💡 نصائح وحيل

• اجمع مع Denoising أو Blur قبل تعزيز التباين لتقليل تضخيم الضوضاء في الصور شديدة الضوضاء.

• استخدم Normalize Image إذا احتجت استراتيجية تطبيع مختلفة أو رغبت في مطابقة التباين بصورة مرجعية.

• بعد التباين التلقائي، اضبط النتيجة بدقة مع Contrast-Brightness-Gamma للتحكم الأفضل في النغمات المتوسطة وgamma.

• راجع النتائج باستخدام Show Image أثناء الضبط، واحفظ النتائج المفضلة باستخدام Image Write أو Image Logger.

• عند التعامل مع مشاكل لونية معينة، جرّب Adjust Colors أو تحويل Color Space قبل تطبيق التباين التلقائي للحصول على توازن ألوان أفضل.

🛠️ استكشاف الأخطاء وإصلاحها

• المخرج يبدو قاسياً أو مقطوعاً: قلل قيمة Threshold للحفاظ على المزيد من الإبرازات/الظلال.

• فقدان التفاصيل في الإبرازات/الظلال: جرّب قيمة Threshold أقل أو اتبع ذلك بتعديلات Contrast-Brightness-Gamma.

• زيادة الضوضاء المرئية بعد التعزيز: طبق Denoising قبل التباين التلقائي، أو قلل قيمة Threshold.

• حدوث انحرافات لونية بعد المعالجة: جرّب تحويل Color Space أو استخدم Adjust Colors قبل التباين التلقائي.

✅ أفضل الممارسات

• ابدأ بقيمة Threshold منخفضة إلى متوسطة وزدها تدريجياً حتى تحصل على التباين المطلوب.

• استخدم Show Image للمقارنة بين قبل/بعد في الوقت الفعلي.

• في خطوط الأنابيب الآلية، اختبر إعدادات العتبة على مجموعة ممثلة من الصور لتجنب المعالجة الزائدة أو الناقصة.