> 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/camera-usb.md).

# Camera USB

Este bloque de función se conecta a las cámaras USB conectadas a tu equipo y proporciona fotogramas en vivo para su procesamiento o visualización. Úsalo para seleccionar una cámara, cambiar la resolución y controlar cuándo la cámara está activa o se libera.

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

`Activate Signal` — Entrada booleana para habilitar la obtención de fotogramas. Cuando no está activa, el bloque mantendrá y devolverá el último fotograma capturado.

`Release Signal` — Entrada booleana para detener y liberar el recurso de la cámara.

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

`Camera Frame` — Fotograma en vivo desde la cámara USB seleccionada.

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

`Scan Connected USB Cameras` — Botón para detectar y listar las cámaras USB conectadas al sistema.

`Select USB Camera` — Menú desplegable para escoger qué cámara conectada usar.

`Camera Resolution` — Menú desplegable para elegir una resolución de captura compatible con la cámara.

`Current Resolution` — Etiqueta de solo lectura que muestra la resolución que la cámara está usando actualmente.

`Open Advanced Setting` — Botón que abre la ventana de configuración del proveedor de la cámara (cuando está disponible en la plataforma).

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

* Descubrimiento y selección sencillos de múltiples cámaras USB.
* Selección de resolución sobre la marcha con la resolución actual visible.
* Control de activación/liberación para liberar la cámara a otras aplicaciones.
* Protección frente a fotogramas corruptos o en blanco con reintentos automáticos.
* Funciona bien como fuente de imagen en vivo para procesos posteriores o flujos de guardado.

## 📝 Cómo usar <a href="#usage" id="usage"></a>

1. Haz clic en el botón `Scan Connected USB Cameras` para rellenar la lista de cámaras.
2. Elige la cámara deseada en `Select USB Camera`.
3. Opcionalmente, cambia `Camera Resolution` y verifica la etiqueta `Current Resolution`.
4. Envía `Activate Signal` (true) para empezar a recibir fotogramas en `Camera Frame`.
5. Cuando termines, envía `Release Signal` (true) para liberar el recurso de la cámara.

## ⚙️ Qué sucede al ejecutarlo <a href="#evaluation" id="evaluation"></a>

Al activarse, el bloque captura el fotograma más reciente de la cámara USB seleccionada y lo emite a través de `Camera Frame`. Si la cámara falla o los fotogramas aparecen en blanco, el bloque intentará recuperarse e informará mediante el área de mensajes y los indicadores de estado.

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

* Previsualiza la salida en vivo conectando `Camera Frame` al bloque `Show Image` para inspeccionar fotogramas y abrir el visor de imágenes.
* Reduce la carga antes de bloques de IA pesados añadiendo un bloque `Image Resizer` o `Image Resize` para reducir la escala de los fotogramas.
* Mejora la calidad visual para tareas de detección insertando `Adjust Colors`, `Auto Contrast` o `Denoising` antes de los detectores de IA.
* Combínalo con `Image ROI Select` para recortar una región específica y acelerar detectores posteriores como `Object Detection` o `Mask Detection`.
* Guarda fotogramas importantes usando `Image Logger` o graba vídeo continuo con `Record Video`.
* Para flujos de extracción de texto, alimenta los fotogramas a `OCR` o `OCR (EasyOCR)` tras asegurarte de un enfoque y contraste claros.
* Usa `Blur` o `Image Threshold` para preprocesar escenas con ruido antes de `Find Object` u otros detectores basados en plantillas.
* Si planeas registros en la nube o remotos, combina la fuente de cámara con `Image Logger` o `CSV Export` para almacenar metadatos junto con los fotogramas.

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

* No aparecen cámaras en la lista: Asegúrate de que la cámara esté conectada y alimentada. Prueba a reconectar el cable USB o cambiar de puerto, y luego pulsa `Scan Connected USB Cameras` de nuevo.
* Cámara ocupada o no puede iniciarse: Cierra otras aplicaciones que puedan estar usando la cámara e intenta liberar y volver a escanear.
* Fotogramas en blanco o corruptos: Intenta seleccionar otra resolución mediante `Camera Resolution` o pulsa el botón de escaneo para reiniciar la cámara. Si el problema persiste, desconecta y vuelve a conectar la cámara.
* Configuración avanzada no disponible: Las limitaciones de la plataforma pueden impedir mostrar las opciones del proveedor; consulta notas específicas de la plataforma o usa la utilidad externa de la cámara.

Si los problemas continúan, prueba a combinar la cámara con una vista previa simple usando `Show Image` para aislar si el problema es de hardware o de un bloque de procesamiento posterior.