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

# Write Date On Image

Ce bloc fonctionnel écrit la date et l'heure courantes en tant que texte sur une image entrante. Il propose des contrôles flexibles pour la police, la taille, la position, la couleur et un fond optionnel pour améliorer la lisibilité. Utilisez ce bloc lorsque vous avez besoin d’images horodatées pour la journalisation, l’enregistrement ou le retour visuel.

## 📥 Entrées

`Image Any` Image qui recevra la superposition de la date (image de n’importe quelle couleur/profondeur).

## 📤 Sorties

`Image Any` Image avec le texte date/heure dessiné dessus.

## 🕹️ Contrôles

`Font Scale` Ajuste la taille relative du texte de la date. Cette valeur s’adapte automatiquement aux dimensions de l’image pour que le texte reste proportionnel.

`Horizontal Position` Déplace le texte de la gauche vers la droite sur l’image (curseur normalisé).

`Vertical Position` Déplace le texte du haut vers le bas sur l’image (curseur normalisé).

`Font Thickness` Modifie l’épaisseur du contour du texte.

`Text Background` Active ou désactive un rectangle de fond rempli derrière le texte pour améliorer le contraste et la lisibilité.

`Font` Choisit le style de police parmi les options disponibles (par ex. Simplex, Duplex, Script).

`Color` Sélectionne la couleur du texte depuis une palette prédéfinie.

## 🎨 Fonctionnalités

* Mise à l’échelle de la police adaptée à l’image afin que la taille du texte s’ajuste automatiquement aux résolutions différentes.
* Placement précis grâce aux curseurs normalisés horizontal et vertical.
* Plusieurs styles de police et préréglages de couleurs pour une configuration rapide.
* Boîte de fond translucide optionnelle derrière le texte pour un fort contraste sur des scènes chargées.
* Aperçu en temps réel lors de l’exécution du bloc pour ajuster facilement le positionnement et la visibilité.

## 📝 Instructions d'utilisation

1. Connectez un bloc producteur d’image à l’entrée `Image Any`.
2. Ajustez `Font Scale`, `Horizontal Position` et `Vertical Position` pour placer l’horodatage à l’endroit souhaité.
3. Choisissez une `Font` et une `Color` visibles sur votre image.
4. Activez éventuellement `Text Background` pour garantir la lisibilité sur des arrière-plans complexes.
5. Exécutez le flux ; le bloc sortira l’image avec la date/l’heure courante appliquée.

L’horodatage écrit utilise un format date-heure compact (date et heure combinées), adapté pour les noms de fichiers et l’inspection visuelle rapide.

## 📊 Évaluation

Lorsqu’il est exécuté, le bloc superpose le texte de la date et de l’heure courantes sur l’image fournie et renvoie l’image modifiée via sa sortie. La superposition est mise à jour à chaque exécution pour refléter le moment courant.

## 💡 Astuces

* Pour prévisualiser le résultat dans l’interface d’édition, connectez la sortie au bloc `Show Image`.
* Si vous enregistrez de nombreuses images horodatées, associez ce bloc avec `Image Logger` ou `Image Write` pour stocker les images avec la superposition.
* Pour les flux d’enregistrement vidéo, envoyez la sortie vers `Record Video` afin que chaque image enregistrée contienne l’horodatage.
* Pour les images très grandes, utilisez `Image Resize` avant ce bloc pour réduire le temps de rendu tout en conservant un texte lisible.
* Si vous devez superposer d’autres informations (ID, compteurs) avec la date, combinez ce bloc avec des blocs qui génèrent du texte ou des nombres et appliquez plusieurs étapes d’écriture/superposition.

## 🛠️ Résolution des problèmes

* Le texte apparaît en dehors de l’image : ajustez `Horizontal Position` et `Vertical Position` pour ramener le texte dans la vue.
* Le texte est difficile à lire sur des arrière-plans chargés : activez `Text Background` ou choisissez une `Color` contrastée.
* Le texte est trop petit ou trop grand : modifiez `Font Scale` et/ou `Font Thickness` jusqu’à obtention d’une lisibilité satisfaisante.
* Traitement lent sur de grandes images : insérez un bloc `Image Resize` avant ce bloc, puis écrivez la date sur l’image redimensionnée ou redimensionnez à nouveau après si nécessaire.