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

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

Este bloque de función no proporciona salidas.

🕹️ Controles

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

• 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

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

• 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

• 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

• 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).