Auto Contrast

Este bloque de función ajusta automáticamente el contraste de una imagen analizando su histograma y estirando los valores de píxel para mejorar la visibilidad. Es ideal para mejorar rápidamente el brillo y contraste de fotos o fotogramas de cámara sin editar curvas manualmente.

📥 Entradas (sockets)

Image Any — Socket de entrada que acepta la imagen a la que se le ajustará el contraste.

📤 Salidas (sockets)

Image Any — Socket de salida que proporciona la imagen con el contraste mejorado.

🕹️ Controles (widgets)

Threshold — Slider para establecer el porcentaje de recorte del histograma (rango típico 1–99). Valores más altos recortan más extremos antes del estirado, produciendo un contraste más marcado.

⚙️ Mecanismo de funcionamiento

Al ejecutar el bloque, analiza el histograma de la imagen de entrada para encontrar puntos de corte bajos y altos según el valor de Threshold. Luego reescala los valores de píxel para que el rango tonal útil ocupe todo el rango de salida disponible. El resultado es una imagen visualmente más brillante y con mayor contraste, intentando preservar detalles dentro del rango no recortado.

🎨 Características

• Recorte automático del histograma para expandir el rango tonal utilizable.

• Control de un solo slider para ajustes rápidos e intuitivos.

• Funciona con imágenes en escala de grises y a color.

• Operación rápida adecuada para vista previa en tiempo real y procesamiento por lotes.

📝 Uso

1. Conecta una fuente de imagen al Image Any de entrada (por ejemplo Camera USB, Camera IP (ONVIF), Load Image).

2. Ajusta el slider Threshold para controlar qué tan agresivo será el recorte del histograma.

3. Usa la salida Image Any del bloque como entrada para bloques de visualización o procesamiento adicional (por ejemplo Show Image, Image Logger, Image Write).

💡 Consejos y trucos

• Combínalo con Denoising o Blur antes de mejorar el contraste para reducir la amplificación de ruido en imágenes muy ruidosas.

• Usa Normalize Image si necesitas otra estrategia de normalización o quieres igualar el contraste a una imagen de referencia.

• Después del auto contraste, ajusta finamente con Contrast-Brightness-Gamma para un control más preciso de los medios tonos y la gamma.

• Previsualiza resultados con Show Image durante el ajuste y guarda resultados preferidos con Image Write o Image Logger.

• Si hay problemas de color, prueba Adjust Colors o Color Space antes de aplicar el auto contraste para obtener un mejor balance de color.

🛠️ Solución de problemas

• Salida demasiado dura o recortada: reduce el valor de Threshold para conservar más luces/sombras.

• Pérdida de detalles en altas/lows: prueba con un Threshold menor o sigue con ajustes de Contrast-Brightness-Gamma.

• Ruido visible aumentado tras la mejora: aplica Denoising antes de auto contraste o reduce Threshold.

• Desplazamientos de color tras el procesamiento: experimenta con la conversión de Color Space o usa Adjust Colors previamente.

✅ Buenas prácticas

• Empieza con un Threshold bajo o moderado y aumenta hasta alcanzar el contraste deseado.

• Usa Show Image para comparar antes/después en tiempo real.

• En pipelines automatizados, prueba los ajustes de Threshold con un conjunto representativo de imágenes para evitar sobre/infra-procesamiento.