> 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/detections-shapes/draw/write-date-on-image.md).

# Write Date On Image

Este bloque de función escribe la fecha y hora actuales como texto sobre una imagen entrante. Ofrece controles flexibles para fuente, tamaño, posición, color y un fondo opcional para mejorar la legibilidad. Usa este bloque cuando necesites imágenes con marca temporal para registro, grabación o retroalimentación visual.

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

`Image Any` — Imagen que recibirá la superposición de fecha (cualquier imagen de color/profundidad).

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

`Image Any` — Imagen con el texto de fecha/hora dibujado.

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

* `Font Scale` — Ajusta el tamaño relativo del texto de la fecha. Este valor se escala automáticamente con las dimensiones de la imagen para mantener la proporción.
* `Horizontal Position` — Mueve el texto de izquierda a derecha sobre la imagen (control normalizado).
* `Vertical Position` — Mueve el texto de arriba a abajo sobre la imagen (control normalizado).
* `Font Thickness` — Cambia el grosor del trazo del texto.
* `Text Background` — Activa o desactiva un rectángulo de fondo relleno detrás del texto para mejorar contraste y legibilidad.
* `Font` — Elige el estilo de letra entre las opciones disponibles (por ejemplo, Simplex, Duplex, Script).
* `Color` — Selecciona el color del texto desde una paleta predefinida.

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

* Escalado de fuente ajustable y consciente del tamaño de la imagen, de modo que el texto se adapte a diferentes resoluciones.
* Colocación precisa mediante los controles normalizados `Horizontal Position` y `Vertical Position`.
* Varias opciones de `Font` y `Color` para una configuración rápida.
* Caja de fondo `Text Background` opcional para alto contraste en escenas complejas.
* Vista previa en tiempo real al ejecutar el bloque para ajustar posición y visibilidad.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta un bloque que produzca imagen al input `Image Any`.
2. Ajusta `Font Scale`, `Horizontal Position` y `Vertical Position` para colocar la marca de tiempo donde la necesites.
3. Elige una `Font` y un `Color` que sean visibles sobre tu imagen.
4. Opcional: activa `Text Background` para asegurar legibilidad en fondos complejos.
5. Ejecuta el flujo; el bloque saldrá con la imagen que contiene la fecha/hora actual.

La marca de tiempo utiliza un formato compacto de fecha y hora (combinados), adecuado para nombres de archivo y revisión visual rápida.

## 📊 Evaluación <a href="#evaluation" id="evaluation"></a>

Al ejecutarse, el bloque superpone el texto con la fecha y hora actuales sobre la imagen proporcionada y devuelve la imagen modificada por su salida. La superposición se actualiza en cada ejecución para reflejar el momento actual.

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

* Para previsualizar en la UI del editor, conecta la salida a un bloque `Show Image`.
* Si guardas muchas imágenes con marca de tiempo, combina este bloque con `Image Logger` o `Image Write` para almacenarlas con la superposición aplicada.
* En flujos de grabación de video, envía la salida a `Record Video` para que cada fotograma grabado contenga la marca temporal.
* Con imágenes muy grandes, usa `Image Resize` antes de este bloque para reducir el tiempo de renderizado sin perder legibilidad.
* Si necesitas añadir más información (IDs, contadores), combina este bloque con bloques que generen texto o números y aplica varias capas de escritura/superposición.

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

* Texto fuera de la imagen: ajusta `Horizontal Position` y `Vertical Position` para traer el texto a la vista.
* Texto difícil de leer en fondos ocupados: activa `Text Background` o elige un `Color` con mayor contraste.
* Texto demasiado pequeño o grande: ajusta `Font Scale` y/o `Font Thickness` hasta que sea legible.
* Procesamiento lento con imágenes grandes: inserta `Image Resize` antes de este bloque y, si es necesario, vuelve a redimensionar después.