Image Translate

Ce bloc de fonction déplace une image horizontalement et/ou verticalement d'un nombre de pixels spécifié. La zone libérée est remplie avec une couleur de fond choisie. Les entrées X displacement, Y displacement et Background Color sont optionnelles — des valeurs vides laissent l'image inchangée ou utilisent des valeurs par défaut.

📥 Entrées

Input Image Une image en niveaux de gris ou en couleur à translater (socket image).

X displacement Décalage horizontal en pixels (socket nombre). Une valeur positive déplace l'image vers la droite, négative vers la gauche. Optionnel — vide = 0.

Y displacement Décalage vertical en pixels (socket nombre). Une valeur positive déplace l'image vers le bas, négative vers le haut. Optionnel — vide = 0.

Background Color Couleur de remplissage pour les zones d'arrière-plan exposées (socket pixel). Optionnel — noir par défaut si non fourni.

📤 Sorties

Translated Image L'image résultante après translation (socket image). L'image de sortie conserve les mêmes dimensions que l'entrée ; le contenu est décalé et les bords sont remplis avec la couleur choisie.

🕹️ Contrôles

X displacement Saisissez le décalage horizontal en pixels. Utilisez des valeurs négatives pour déplacer vers la gauche.

Y displacement Saisissez le décalage vertical en pixels. Utilisez des valeurs négatives pour déplacer vers le haut.

Background Color Choisissez une couleur d'arrière-plan pour remplir les nouvelles zones vides (utilisez une entrée de type Pixel ou un bloc produisant une couleur).

✨ Fonctionnalités

• Entrées optionnelles : laissez X displacement ou Y displacement vide pour conserver cet axe inchangé.

• Préserve la taille de l'image d'entrée ; le contenu translaté est recadré selon la toile originale.

• Fonctionne avec des images en niveaux de gris et en RGB.

• Le remplissage d'arrière-plan accepte des valeurs mono-canal ou RGB selon l'image d'entrée.

📝 Instructions d'utilisation

1. Connectez un bloc producteur d'image à Input Image.

2. Fournissez des valeurs en pixels à X displacement et/ou Y displacement pour déplacer l'image.

3. Facultativement, fournissez Background Color pour contrôler le remplissage des zones exposées.

4. Utilisez la sortie Translated Image comme entrée pour les blocs en aval (affichage, analyse, sauvegarde).

Exemples :

• Déplacer une image de 50 pixels vers la droite et 20 pixels vers le bas en réglant X displacement = 50 et Y displacement = 20.

• Ne déplacer que verticalement en renseignant Y displacement et en laissant X displacement vide.

📊 Comportement à l'exécution

Lors de l'exécution, le bloc lit l'image d'entrée et les valeurs de décalage, décale les pixels selon la valeur demandée, remplit les régions découvertes avec la couleur choisie, et renvoie l'image translatée sur la sortie Translated Image. Les valeurs de décalage manquantes sont traitées comme zéro.

💡 Astuces

• Pour éviter que des parties importantes de l'image soient coupées après la translation, ajoutez une marge autour de l'image à l'aide de Image Padding ou augmentez la taille de la toile avec Image Resize / Make Image pour créer un arrière-plan, puis translatez dans la toile plus grande.

• Utilisez Pixel ou un petit bloc Make Image pour créer une couleur d'arrière-plan précise et l'alimenter dans Background Color.

• Combinez avec Image ROI ou Image ROI Select pour translater uniquement une zone recadrée, puis utilisez Image Concatenate ou Collage Images pour réassembler/visualiser les résultats.

• Si vous devez retourner ou faire pivoter le contenu après translation, chaînez Flip Image ou Rotate Image Angle après ce bloc.

• Pour des mises en page en mosaïque ou des compositions, translatez plusieurs tranches puis fusionnez-les avec Image Concatenate ou Merge Channels selon les besoins.

🛠️ Dépannage

• Problème : des parties importantes de l'image sont coupées après la translation. Solution : ajoutez une marge avant la translation avec Image Padding ou augmentez la taille de la toile via Image Resize / Make Image, puis translatez.

• Problème : la couleur d'arrière-plan ne correspond pas au résultat attendu. Solution : assurez-vous que l'entrée Background Color fournit le format de canal correct (valeur unique pour le niveau de gris, triplet RGB pour la couleur). Utilisez Pixel pour fournir la couleur exacte.

• Problème : aucune modification après avoir fourni des déplacements. Solution : vérifiez que les entrées de décalage sont connectées et non vides ; les valeurs vides correspondent à zéro.

• Problème : préserver la qualité de l'image lors de translations importantes. Solution : envisagez de translater sur une toile plus grande d'abord et évitez les recadrages successifs ; utilisez des blocs en aval comme Show Image pour vérifier les résultats.