Image Write

Este bloque de función guarda imágenes de entrada en disco cuando la condición de guardado está activa. Soporta compresión opcional (JPEG) y nombrado automático; está pensado para exportar fácilmente imágenes capturadas o procesadas.

📥 Inputs

Folder Path Ruta completa de la carpeta donde se guardará la imagen. Si se deja vacía, se usa la carpeta de trabajo actual.

File Name Nombre de archivo opcional sin extensión. Si se deja vacío, se utilizará automáticamente un nombre basado en la marca de tiempo.

Save Trigger booleano que controla si la imagen se escribirá en disco. Proporcione TRUE para guardar, FALSE para inhibir el guardado.

Input Image Imagen a guardar. Acepta cualquier formato de imagen común proveniente de bloques previos.

📤 Outputs

Este bloque de función no genera salidas (sockets) de datos. Informa su estado a través de mensajes de log visibles en la interfaz.

🕹️ Controls

Compress Image Checkbox para alternar el guardado como archivo JPEG comprimido en lugar de PNG sin compresión. Use compresión para reducir el tamaño de archivo cuando el espacio en disco o el ancho de banda de transferencia sea limitado.

🎨 Features

• Guardado bajo demanda usando la entrada booleana Save.

• Nombre de archivo automático (fallback) usando una marca de tiempo cuando no se proporciona ninguno.

• Opción de guardar como JPEG comprimido o PNG sin pérdida.

• Mensajes de log informativos que confirman el éxito o reportan errores (carpeta inexistente, permisos, o imagen faltante).

• Control de UI sencillo para habilitar/deshabilitar la compresión.

⚙️ Mecanismo de ejecución

Cuando la entrada Save está activa (TRUE), el bloque intenta escribir la Input Image actual en la ruta definida por Folder Path y File Name. Si Compress Image está marcado, la imagen se guarda como JPEG para reducir tamaño; de lo contrario se guarda como PNG. Si la carpeta no existe o la imagen falta, el bloque registra un error en lugar de guardar.

📝 Usage Instructions

1. Proporcione un destino usando la entrada Folder Path o déjelo vacío para usar la carpeta por defecto.

2. Opcionalmente, establezca un File Name o déjelo vacío para usar un nombre automático con marca de tiempo.

3. Alimente la imagen que desea guardar al socket Input Image.

4. Active la entrada Save (por ejemplo con un trigger manual o programático) para escribir el archivo.

5. Use la casilla Compress Image para elegir entre JPEG (más pequeño) o PNG (sin pérdida).

💡 Tips and Tricks

• Use Choose Folder para permitir que los usuarios seleccionen la carpeta destino de forma interactiva antes de guardar.

• Combine con String Input o Date-Time para construir nombres descriptivos y con marca temporal.

• Previsualice la imagen con Show Image antes de guardar para verificar el contenido.

• Si las imágenes son grandes, agregue Image Resizer antes de este bloque para reducir el tamaño guardado y mejorar el rendimiento.

• Use Image ROI Select o Draw Result On Image para recortar o anotar imágenes antes de guardarlas (por ejemplo: guardar regiones detectadas o resultados superpuestos).

• Para registrar muchas imágenes a alta frecuencia, considere usar Image Logger o Record Video en lugar de guardar fotogramas individuales en cada trigger.

🛠️ Troubleshooting

• Carpeta inexistente o error de permisos: verifique la ruta provista en Folder Path y utilice Choose Folder para evitar errores tipográficos.

• Error "No image data available": asegúrese de que el socket Input Image esté recibiendo datos de imagen válidos antes de activar Save. Previsualice con Show Image para confirmar.

• Archivos grandes o guardados lentos: habilite Compress Image o inserte Image Resizer para reducir la resolución antes de guardar.

• Nombres de archivo inesperados: incluya Date-Time o un String Input personalizado para generar nombres únicos y descriptivos y evitar sobrescrituras.

Si guarda repetidamente en intervalos cortos, asegúrese de que el almacenamiento destino tenga espacio libre suficiente y rendimiento de escritura adecuado para su escenario.