> 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/spanish/function-blocks/blocks-reference/image-transformations/transformation-filters/contrast-brightness-gamma.md).

# Contrast-Brightness-Gamma

Este bloque de función permite ajustar el contraste, brillo y gamma de una imagen mediante tres deslizadores sencillos. Es ideal para una afinación visual rápida o como paso de preprocesamiento antes de análisis posteriores.

## 📥 Entradas (sockets) <a href="#inputs" id="inputs"></a>

* `Image Any` Imagen de entrada a ajustar.

## 📤 Salidas (sockets) <a href="#outputs" id="outputs"></a>

* `Image Any` Imagen ajustada después de aplicar contraste, brillo y gamma.

## 🕹️ Controles <a href="#controls" id="controls"></a>

* `Contrast Value` Deslizador para aumentar o disminuir el contraste de la imagen.
* `Brightness Value` Deslizador para elevar o bajar el brillo de la imagen.
* `Gamma Value` Deslizador para aplicar corrección gamma y ajustar los tonos medios.

## 🎨 Características <a href="#features" id="features"></a>

* Afinación visual en tiempo real mediante deslizadores para experimentación rápida.
* Operaciones combinadas: contraste y brillo se aplican primero, seguidos de la corrección gamma para un control tonal suave.
* Funciona con cualquier formato de imagen soportado por el sistema (color o escala de grises).

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta una imagen al socket de entrada `Image Any`.
2. Mueve el deslizador `Contrast Value` para ajustar el contraste. Los valores positivos aumentan el contraste; los negativos lo suavizan.
3. Mueve el deslizador `Brightness Value` para aclarar u oscurecer la imagen.
4. Ajusta el deslizador `Gamma Value` para corregir los tonos medios sin afectar demasiado los extremos.
5. La imagen procesada estará disponible en el socket de salida `Image Any` para vista previa o uso en bloques posteriores.

## 📊 Evaluación <a href="#evaluation" id="evaluation"></a>

Al ejecutarse, el bloque produce una imagen ajustada que refleja las posiciones actuales de los deslizadores. Usa esta salida para alimentar bloques posteriores de análisis, visualización o almacenamiento.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Para imágenes con ruido, usa el bloque `Denoising` antes de este bloque para evitar amplificar el ruido al incrementar el contraste.
* Si buscas mejoras automáticas, combina este bloque con `Auto Contrast` para obtener una base rápida antes del ajuste fino manual.
* Para acelerar el procesamiento en imágenes muy grandes, coloca `Image Resizer` corriente arriba para reducir el tamaño antes del ajuste.
* Usa `Show Image` después de este bloque para inspeccionar resultados en un visor más grande.
* Para generar registros o archivos, conecta el resultado a `Image Logger` o `Image Write` para guardar los fotogramas ajustados.
* Como fuentes de imagen típicas puedes usar `Load Image`, `Camera USB` o `Camera IP (ONVIF)` según tu flujo de trabajo.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Si la imagen parece excesivamente contrastada o recortada, reduce `Contrast Value` o baja `Brightness Value` y aplica ajustes moderados de `Gamma Value`.
* Si los colores se ven extraños tras ajustes intensos, prueba `Auto Contrast` o `Normalize Image` para reequilibrar los rangos de píxeles.
* Si la capacidad de respuesta en tiempo real es lenta, reduce la resolución de la imagen de entrada con `Image Resizer` antes de ajustar.