> 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/outputs-exports/record-video.md).

# Record Video

Este bloque de función guarda los fotogramas de imagen entrantes en un archivo de video. Puede iniciar y detener la grabación con un disparador booleano o usar el disparador integrado `Spacebar`. Hay varios modos de calidad disponibles, incluida una opción de alta compresión que utiliza `ffmpeg` si está instalado.

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

`Frame` Los fotogramas de imagen de entrada que se grabarán.

`Record` Control booleano para iniciar/detener la grabación (se usa según el modo de disparo elegido).

`Folder Path` La carpeta donde se guardarán los videos grabados.

`File Name (no extension)` Nombre base del archivo opcional. Si se deja vacío, se usará una marca de tiempo.

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

Este bloque de función no proporciona salidas.

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

`Video Quality` Elija entre modos de calidad:

* `Compressed` archivos más pequeños, rápido.
* `High Quality` menos compresión, mejor fidelidad visual.
* `High-Compress(requires ffmpeg)` mejor compresión pero requiere que `ffmpeg` esté disponible en el sistema.

`Trigger Mode` Elija cómo se inicia/detiene la grabación:

* `Spacebar` presione la barra espaciadora para alternar inicio/detención (requiere disponibilidad del hook de teclado en su OS).
* `Continuous` proporcione TRUE para iniciar y FALSE para detener.
* `Once` un flanco ascendente TRUE inicia la grabación y un TRUE posterior detiene y guarda.

`Recording` LED Indicador visual que muestra si la grabación está activa.

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

* Iniciar/detener la grabación usando tres modos de disparo (`Spacebar`, `Continuous`, `Once`).
* Múltiples modos de calidad, incluida una opción de alta compresión basada en `ffmpeg`.
* Selección automática de códecs y contenedores disponibles para portabilidad.
* Evita abrir el archivo de video mientras se graba (para prevenir conflictos de archivos).
* Conversión en segundo plano para el modo `High-Compress` para que la compresión no bloquee la captura en tiempo real (requiere `ffmpeg`).

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

1. Proporcione fotogramas a `Frame` (por ejemplo desde `Camera USB`, `Camera IP (ONVIF)`, o `Stream Reader`).
2. Configure `Folder Path` donde se deben guardar los videos.
3. Opcionalmente, establezca `File Name (no extension)` o déjelo vacío para usar una marca de tiempo.
4. Seleccione la `Video Quality` deseada. Si necesita archivos lo más pequeños posible y la mayor compresión, elija la opción `High-Compress(requires ffmpeg)` y asegúrese de que `ffmpeg` esté instalado.
5. Elija `Trigger Mode`:
   * Para control rápido por teclado use `Spacebar` (funciona cuando su OS lo permite).
   * Para control programático use `Continuous` o `Once` y alimente valores booleanos en `Record`.
6. Inicie la grabación según el disparador seleccionado. El LED `Recording` se encenderá mientras captura.
7. Detenga la grabación y deje que el bloque finalice el archivo de video. Si se seleccionó el modo `High-Compress`, la compresión final puede ejecutarse en segundo plano.

## 📊 Comportamiento en ejecución <a href="#evaluation" id="evaluation"></a>

* Cuando la grabación está activa, los fotogramas entrantes de `Frame` se agregan al archivo de video abierto.
* Al detenerse, el archivo se cierra. Si se seleccionó la opción de alta compresión y `ffmpeg` está presente, se puede lanzar una conversión en segundo plano para crear un archivo más pequeño y altamente comprimido.
* Si el disparador `Spacebar` no está disponible (común en algunas configuraciones de Linux sin privilegios elevados), el bloque mostrará una advertencia y puede usar los modos `Continuous` o `Once` en su lugar.

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

* Para grabar desde una cámara local, conecte `Camera USB` o `Camera USB External` a la entrada `Frame`.
* Para cámaras de red, use `Camera IP (ONVIF)` o `Stream Reader` como fuente para una obtención de fotogramas más fluida en segundo plano.
* Previsualice los fotogramas en vivo enviando la misma fuente al bloque `Show Image` junto a este bloque.
* Guarde fotogramas individuales para inspección en paralelo usando `Image Logger` o `Image Write` mientras el bloque graba video.
* Active la grabación automáticamente cuando aparezca algo importante conectando bloques de detección (por ejemplo `Object Detection` o `Mask Detection`) a un flujo lógico que controle la entrada `Record`.
* Use `Keyboard/Barcode Reader` si necesita disparadores de teclado más complejos o entradas externas dirigidas a `Record`.
* Si necesita un menor uso de almacenamiento pero aún buena calidad, elija `High-Compress(requires ffmpeg)` e instale `ffmpeg` en el PATH del sistema.

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

* Disparador `Spacebar` no funciona en Linux: ejecute Studio con privilegios elevados (o use los modos `Continuous`/`Once`).
* Compresión no disponible: asegúrese de que `ffmpeg` esté instalado y accesible en el PATH del sistema para habilitar la opción `High-Compress`. Si falta `ffmpeg`, el bloque caerá en un modo sin `ffmpeg` y mostrará una advertencia.
* Archivo en uso durante la grabación: el archivo de video no puede abrirse por otras aplicaciones mientras se graba. Espere a que la grabación termine.
* No se guardan fotogramas: verifique que la fuente conectada a `Frame` esté proporcionando imágenes válidas (previsualice con `Show Image` para ayudar).