Write Text On Image

Cette fonction ajoute du texte personnalisable sur des images. Le texte est mis à l'échelle par rapport à la taille de l'image, peut être positionné avec des coordonnées normalisées, et peut afficher un fond semi-transparent derrière le texte pour améliorer la lisibilité.

📥 Entrées

Image Any Reçoit l'image sur laquelle écrire le texte.

String Texte optionnel. Si laissé vide, le bloc dessinera une chaîne vide (aucun texte visible).

📤 Sorties

Image Any L'image avec le texte appliqué.

🕹️ Contrôles

Text Position Horizontal Déplace le texte gauche/droite avec une valeur normalisée (0.0 = gauche, 1.0 = droite).

Text Position Vertical Déplace le texte haut/bas avec une valeur normalisée (0.0 = haut, 1.0 = bas).

Font Scale Ajuste la taille globale du texte par rapport à l'image.

Font Thickness Ajuste l'épaisseur du trait du texte.

Font Choisit le style de police parmi les options disponibles.

Color Sélectionne la couleur du texte.

Background Enabled Active/Désactive un rectangle de fond semi-transparent derrière le texte pour un meilleur contraste.

🎨 Caractéristiques

• Mise à l'échelle automatique : la taille du texte s'adapte aux dimensions de l'image pour un rendu cohérent.

• Positionnement normalisé : placez le texte proportionnellement, indépendamment de la taille de l'image.

• Option de fond semi-transparent pour améliorer la lisibilité sur des images chargées.

• Fonctionne avec des textes dynamiques pour afficher des contenus variables (ID, étiquettes, valeurs de capteurs, etc.).

📊 Fonctionnement

Au lancement, le bloc lit l'image d'entrée et les réglages actuels, calcule une échelle de police et une position adaptées à la taille de l'image, dessine le rectangle de fond optionnel (si activé), rend le texte avec la police, la couleur et l'épaisseur choisies, puis renvoie l'image annotée pour les blocs suivants.

📝 Mode d'emploi

1. Branchez une source d'image sur l'entrée Image Any.

2. Fournissez un texte à l'entrée String ou laissez vide pour utiliser le texte interne du bloc.

3. Ajustez Font, Color, Font Scale et Font Thickness pour l'apparence souhaitée.

4. Placez le texte avec Text Position Horizontal et Text Position Vertical.

5. Activez Background Enabled si vous avez besoin d'un meilleur contraste sur des images complexes.

6. Prévisualisez le résultat en connectant ce bloc à un affichage comme Show Image ou sauvegardez avec Image Write / Image Logger.

💡 Astuces

• Pour afficher une horodatation en direct, alimentez String depuis les blocs Date-Time ou Date-Time List et formatez avec String Merge avant de l'envoyer.

• Pour un aperçu en direct lors des réglages, connectez la sortie à Show Image.

• Si vous voulez écrire uniquement dans une zone spécifique, recadrez d'abord avec Image ROI ou Image ROI Select puis appliquez ce bloc.

• Pour une taille de texte cohérente sur des résolutions variées, utilisez Image Resize avant d'écrire le texte.

• Pour sauvegarder des images annotées, connectez la sortie à Image Logger ou Image Write.

• Pour superposer des résultats de détection, combinez avec des blocs comme Find Object ou Object Detection et envoyez les labels ou compteurs détectés vers String.

• Pour du texte conditionnel (par ex. OK / NOK), utilisez des blocs logiques (par ex. Logic Input ou des blocs de comparaison) et String Merge pour assembler le texte avant de l'envoyer à ce bloc.

🛠️ Dépannage

• Texte trop petit ou trop grand : ajustez Font Scale ou redimensionnez l'image d'entrée avec Image Resize.

• Texte illisible sur un fond chargé : activez Background Enabled ou changez la Color pour une meilleure contraste.

• Position du texte incorrecte selon les images : utilisez les positions normalisées Text Position Horizontal et Text Position Vertical et vérifiez le placement sur une image représentative avec Show Image.