> 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/input-output/image-inputs/basler-camera.md).

# Basler Camera

Este bloque de función se conecta a una cámara Basler y proporciona fotogramas en vivo para tu escenario. Está diseñado para cámaras industriales y ofrece configuración de red y controles de tiempo de espera adecuados para la captura fiable de fotogramas.

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

Este bloque no requiere entradas.

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

`Image`\
Último fotograma de la cámara. Si la cámara no está disponible, la salida quedará vacía (None) hasta que se pueda recuperar un fotograma.

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

`IP Address`\
Introduce la dirección IP de la cámara. Déjalo vacío para intentar usar la primera cámara Basler detectada en la red.

`NAT Address`\
Opcional. Úsalo cuando la cámara sea accesible a través de una dirección NAT diferente de la IP de la cámara.

`Destination Address`\
Opcional. Úsalo cuando la cámara deba enviar multicast o esté encaminada a una dirección específica de un equipo.

`Trigger Ready Timeout (ms)`\
Tiempo máximo de espera (milisegundos) antes de enviar un trigger por software a la cámara.

`Retrieve Result Timeout (ms)`\
Tiempo máximo de espera (milisegundos) para recibir el fotograma después de enviar el trigger.

Nota: El bloque intentará (re)conectarse automáticamente cuando los parámetros cambien. Usa los controles anteriores para configurar la conectividad y los tiempos de espera.

## 🎨 Funciones <a href="#features" id="features"></a>

* Conexión fiable a cámaras Basler con soporte para IP y NAT.
* Controles de timeout para ajustar la capacidad de respuesta frente a retrasos de red o cámara.
* Reconexión automática al cambiar parámetros o ante fallos temporales.
* Entrega en tiempo real del fotograma más reciente para su procesamiento posterior.

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

1. Rellena `IP Address` si conoces la dirección de la cámara. Si no, déjalo vacío para usar la primera cámara Basler disponible.
2. Opcionalmente configura `NAT Address` o `Destination Address` si tu red lo requiere.
3. Ajusta `Trigger Ready Timeout (ms)` y `Retrieve Result Timeout (ms)` si observas retrasos o timeouts.
4. Añade bloques posteriores que consuman la salida `Image` para construir tu flujo de procesamiento.

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

Al ejecutarse, este bloque proporcionará el fotograma más reciente de la cámara Basler configurada en la salida `Image`. Si la cámara no es accesible o no se puede recuperar un fotograma, la salida permanecerá vacía hasta que se restablezca la conexión.

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

* Previsualiza fotogramas rápidamente conectando la salida `Image` a `Show Image`.
* Guarda fotogramas o secuencias con `Image Logger` o `Record Video` para revisiones fuera de línea.
* Si los bloques de IA tienen problemas con fotogramas muy grandes, inserta `Image Resizer` antes del procesamiento intensivo para reducir el tamaño y mejorar el rendimiento.
* Para tareas de detección o inspección, combínalo con `Object Detection`, `Object Detection - Custom` o `Mask Detection` para analizar fotogramas en vivo.
* Usa `Super Resolution` tras la captura cuando necesites mejorar el detalle visual para análisis posteriores.
* Recorta o centra áreas de interés con `Image ROI Select` o `Image ROI` antes de aplicar detectores para reducir falsos positivos y acelerar el procesamiento.

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

* Si no aparecen fotogramas, verifica la conectividad de red y que la cámara esté encendida y accesible en la dirección configurada.
* Si los fotogramas tardan o se producen timeouts, aumenta `Trigger Ready Timeout (ms)` y/o `Retrieve Result Timeout (ms)`.
* Si la conexión sigue fallando tras cambiar parámetros, verifica las direcciones configuradas y considera reiniciar la cámara o los equipos de red.