> 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/image-transformations/operations/image-translate.md).

# 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 <a href="#inputs" id="inputs"></a>

`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 <a href="#outputs" id="outputs"></a>

`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 <a href="#controls" id="controls"></a>

`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 <a href="#features" id="features"></a>

* 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 <a href="#usage" id="usage"></a>

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 <a href="#evaluation" id="evaluation"></a>

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 <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* 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 <a href="#troubleshooting" id="troubleshooting"></a>

* 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.