# Video

Este bloque de función reproduce un archivo de video y entrega fotogramas individuales para su procesamiento. Te permite elegir un archivo, controlar el modo de reproducción y proporciona una `Timestamp` y la información de loop/restart junto con cada fotograma.

## 📥 Entradas

`Restart`\
Este socket de entrada acepta un booleano que, cuando es verdadero, reinicia la reproducción del video desde el principio. (Input socket)

## 📤 Salidas

`Image Any`\
Imagen del fotograma leída del video. (Output socket)

`Timestamp`\
Marca de tiempo legible para el fotograma actual dentro del video. (Output socket)

`Restarted`\
Bandera booleana que se vuelve verdadera cuando el video llega al final y se reinicia. (Output socket)

## 🕹️ Controles

`Select video file`\
Botón para elegir el archivo de video a reproducir. (Control)

`Real-time`\
Interruptor para habilitar o deshabilitar la reproducción en tiempo real. Si está activo, los fotogramas avanzan para coincidir con la tasa de frames original del video. (Control)

## 🎨 Características

* Reproducción fluida con sincronización opcional en tiempo real para que los fotogramas sigan la temporización original del video.
* Salida a nivel de fotograma con una cadena de `Timestamp` conveniente para cada frame.
* Comportamiento de bucle (loop) y control de reinicio para volver a iniciar la reproducción.
* Posibilidad de previsualizar o enviar fotogramas a bloques de procesamiento posteriores (por ejemplo detecciones, registro o guardado).
* Manejo opcional de fotogramas en segundo plano para integraciones que suben o registran fotogramas externamente.

## ⚙️ Mecanismo de ejecución

* Cuando se selecciona un archivo de video, el bloque lo abre y prepara la reproducción.
* Si el interruptor `Real-time` está activado, el bloque avanza los fotogramas para que la velocidad de reproducción coincida con los fps del video. Si está desactivado, los fotogramas avanzan tan rápido como el sistema evalúe el grafo.
* Enviar un valor true a la entrada `Restart` reiniciará la reproducción al primer fotograma.
* En cada evaluación se emite el fotograma más reciente, una `Timestamp` legible que indica la posición del fotograma en el video y un booleano que indica si el video hizo loop o se reinició.

## 📝 Instrucciones de uso

1. Haz clic en el botón `Select video file` y elige un archivo de video compatible.
2. Activa `Real-time` si quieres que la reproducción coincida con la velocidad original; desactívalo para avanzar fotogramas tan rápido como permita el procesamiento.
3. Opcionalmente, envía un valor true a la entrada `Restart` para reiniciar la reproducción.
4. Conecta la salida `Image Any` a bloques de visualización o análisis para procesar cada fotograma.

## 💡 Consejos y trucos

* Previsualiza fotogramas mientras desarrollas: conecta `Image Any` a `Show Image` para inspeccionar rápidamente los frames.
* Guarda fotogramas o grabaciones importantes: enruta `Image Any` a `Image Logger` o `Record Video` para almacenar fotogramas o crear un archivo de video.
* Reduce la carga de procesamiento: añade un `Image Resizer` o `Image Resize` antes de bloques costosos (por ejemplo `Object Detection` o `Pose Estimation`) para bajar la resolución y aumentar el rendimiento.
* Mejora la calidad de detección: aplica `Denoising` antes de modelos de detección u estimación para reducir ruido.
* Flujos con sustracción de fondo: combina con `Background Subtractor` para detectar objetos en movimiento antes de enviar resultados a `Object Detection` o `Blob Detector`.
* Procesamiento limitado por región: usa `Image ROI Select` o `Image ROI` para recortar áreas de interés y luego ejecuta `Find Object`, `Mask Detection` u OCR en esa región.
* Seguimiento y análisis: empareja `Object Detection` (o `Object Detection - Custom`) con `Object_Detection_Tracker` para rastrear detecciones entre fotogramas y envía la salida del tracker a bloques de análisis como `Traffic Intersection Analysis`.
* Extracción de texto: usa `OCR` o `OCR (EasyOCR)` en los fotogramas (opcionalmente tras recortar con `Image ROI Select`) para leer etiquetas o timestamps impresos.

Sugerencia: para trabajar con videos largos, considera desactivar `Real-time` durante la configuración y las pruebas para iterar más rápido; actívalo en la ejecución final para reproducción sincronizada.

## 🛠️ Solución de problemas

* No aparecen fotogramas: verifica que seleccionaste un archivo válido con `Select video file` y que el archivo es accesible.
* Reproducción demasiado lenta: si `Real-time` está activado pero el sistema no puede seguir, prueba desactivar `Real-time` o reducir el tamaño de los fotogramas con `Image Resizer`.
* El video se reinicia inesperadamente: el fin de archivo activa la bandera de reinicio en la salida; usa la entrada `Restart` para controlar explícitamente la posición de reproducción.
* Las `Timestamp` parecen incorrectas: las marcas de tiempo se calculan en relación con la duración del video; verifica los metadatos del archivo y prueba con otro archivo si los valores no coinciden.

Si planeas transmitir fotogramas a servicios en la nube o de registro, combina este bloque con `Image Logger`, `Record Video` u otros bloques de exportación para persistir los resultados.