Play Folder

Esta función reproduce imágenes desde una carpeta seleccionada, devolviendo un archivo por evaluación. Úsala para recorrer conjuntos de imágenes paso a paso, previsualizar secuencias o alimentar imágenes a procesos posteriores. Puedes elegir una carpeta por defecto con el botón de selección de carpeta, sobrescribirla mediante la entrada Folder Path, filtrar archivos con un patrón glob y controlar la reproducción con las opciones Mode y Order.

📥 Entradas

Folder Path Entrada de tipo string (opcional) que sobrescribe la carpeta por defecto seleccionada con el botón. Proporciona una ruta completa de carpeta para cambiar la fuente en tiempo de ejecución.

Restart Entrada booleana opcional. Cuando es True, el bloque reinicia la reproducción según el Mode actual y devuelve la imagen de borde reiniciada en esa evaluación.

Notas: Estos son sockets de entrada.

📤 Salidas

Image La imagen actual leída desde la carpeta. Este es un socket de salida de imagen.

File Path Ruta absoluta del archivo de imagen actual. Este es un socket de salida de tipo string.

Restarted Booleano que es True cuando el bloque devolvió en esta evaluación una imagen de borde envuelta o reiniciada. Este es un socket de salida.

Notas: Estos son sockets de salida.

🕹️ Controles

Select folder Botón para elegir la carpeta por defecto usada cuando Folder Path está vacío.

Glob pattern Campo de texto para filtrar archivos usando la sintaxis glob de Python (ejemplos: *, *.png, **/*).

Mode Menú desplegable para controlar la dirección de reproducción: Forward, Backward o Stop.

Order Menú desplegable para seleccionar el orden de los archivos: Name (orden natural por nombre de archivo) o Time (por fecha de modificación).

Notas: Estos son widgets visibles que afectan cómo el bloque selecciona y devuelve archivos.

🎨 Características

• Gestión de lista de reproducción: construye y cachea una lista de archivos de imagen que coinciden con la carpeta elegida, el patrón glob y el orden.

• Reproducción flexible: soporta modos forward, backward y stop con comportamiento de envoltura (wrap-around).

• Sobrescritura de carpeta: permite sobrescribir en tiempo de ejecución vía la entrada Folder Path sin cambiar la carpeta por defecto guardada.

• Manejo de reinicio: la entrada explícita Restart reinicia la reproducción y devuelve la imagen de borde en esa evaluación.

• Salida de metadatos de archivo: devuelve la ruta absoluta para facilitar el registro o el procesamiento posterior.

• Subida asíncrona opcional de frames: si está disponible, los fotogramas pueden subirse en segundo plano para registro remoto.

⚙️ Mecanismo de ejecución

En cada evaluación, el bloque determina la carpeta efectiva (por defecto o sobrescrita), comprueba el patrón glob y el orden, y actualiza su lista interna de reproducción cuando es necesario. Lleva un índice actual y devuelve la imagen en ese índice junto con su ruta de archivo y la bandera Restarted. Tras devolver la imagen actual, el bloque prepara el índice siguiente según el Mode seleccionado (forward/backward/stop), envolviéndose al inicio o al final cuando sea necesario.

📝 Instrucciones de uso

1. Haz clic en el botón Select folder para elegir una carpeta por defecto, o déjalo vacío y proporciona una ruta en tiempo de ejecución mediante la entrada Folder Path.

2. Introduce un Glob pattern para filtrar archivos (usa * para todo o *.jpg / **/*.png para tipos específicos).

3. Elige Mode para avanzar, retroceder o mantener la imagen actual entre evaluaciones.

4. Selecciona Order para ordenar archivos por nombre o por fecha de modificación.

5. Opcionalmente envía Restart = True para reiniciar la reproducción hacia la imagen de borde correspondiente al modo actual.

💡 Consejos y trucos

• Previsualiza imágenes en una ventana más grande enviando la salida Image al bloque Show Image para verlas interactivamente mientras avanzas por la carpeta.

• Guarda fotogramas interesantes usando Image Write o exporta por lotes ejemplos con Image Logger conectado a la salida Image.

• Si las imágenes son demasiado grandes para bloques de IA posteriores, conecta Image Resize o Image Resizer después de la salida Image para reducir el tiempo de procesamiento.

• Para centrarte en un área específica de cada imagen antes del análisis, añade Image ROI Select (o Image ROI) tras este bloque y alimenta el recorte a detectores como Find Object o Mask Detection.

• Para informes visuales o vistas combinadas, recoge varios fotogramas y pásalos a Collage Images o Image Concatenate.

• Al construir flujos basados en datasets, usa la salida File Path para crear registros o CSV junto a los datos de imagen mediante bloques de exportación de datos.

(pista: combina únicamente con los function blocks listados disponibles en el entorno.)

🛠️ Solución de problemas

• No se encontraron archivos: Comprueba que la carpeta seleccionada contiene extensiones de imagen soportadas y que el Glob pattern coincide con tus nombres de archivo.

• Sobrescritura de carpeta inválida: Asegura que la entrada Folder Path sea una cadena no vacía y apunte a un directorio existente.

• Orden inesperado: Usa Order = Time para ordenar por marca de tiempo de modificación; usa Name para un orden predecible por nombre de archivo (el orden natural maneja partes numéricas).

• Reproducción que no avanza: Verifica que la configuración de Mode no esté en Stop y que el bloque reciba evaluaciones (algunos modos de ejecución solo corren cuando el escenario se ejecuta).