> 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-padding.md).

# Image Padding

Ce bloc de fonction ajoute une bordure de couleur constante (padding) autour d'une image. Utilisez-le pour créer des marges, uniformiser les tailles d'images ou préparer des images pour la concaténation et la mise en page sans modifier le contenu original.

## 📥 Entrées

`Input Image`\
L'image à laquelle le padding sera appliqué.

`Padding Size`\
Nombre de pixels à ajouter (appliqué selon le côté choisi).

`Color`\
Couleur du remplissage en tant que valeur pixel (B, G, R). Si non fourni, le noir est utilisé.

## 📤 Sorties

`Padded Image`\
L'image résultante avec le padding ajouté.

## 🕹️ Contrôles

`Padding Side`\
Choisissez le(s) côté(s) sur lesquels appliquer le padding. Options disponibles :

* `ALL`
* `VERTICAL`
* `HORIZONTAL`
* `LEFT`
* `RIGHT`
* `TOP`
* `BOTTOM`

Ce contrôle détermine où les pixels de padding sont ajoutés par rapport à l'`Input Image`.

## 🎨 Fonctionnalités

* Bordure de couleur fixe appliquée autour de l'image.
* Sélection flexible des côtés pour n'ajouter du padding que là où c'est nécessaire.
* Accepte une couleur en entrée pour assortir l'arrière-plan ou mettre en évidence des marges.

## 📝 Instructions d'utilisation

1. Fournissez une image sur `Input Image`.
2. Indiquez le nombre de pixels dans `Padding Size` pour définir l'épaisseur de la bordure.
3. Facultatif : fournissez une couleur dans `Color` (format : (Blue, Green, Red)). Si laissé vide, le padding sera noir.
4. Sélectionnez le côté voulu avec `Padding Side` et lancez le scénario pour obtenir `Padded Image`.

## 📊 Évaluation

À l'exécution, ce bloc retourne l'image avec le padding appliqué selon le côté, la taille et la couleur choisis. Utilisez cette sortie directement dans des blocs de visualisation ou de traitement en aval.

## 💡 Astuces

* Pour mettre plusieurs images sur une même toile pour comparaison visuelle : utilisez d'abord `Image Resize` pour faire correspondre hauteurs ou largeurs, puis ce bloc pour ajouter un padding symétrique et aligner visuellement les images.
* Pour vous concentrer sur une région recadrée puis ajouter un fond : combinez `Image ROI Select` (pour recadrer) → ce bloc (pour ajouter la bordure) → `Show Image` pour prévisualiser.
* Pour créer des marges avant de combiner des images côte à côte : ajoutez du padding puis utilisez `Image Concatenate` ou `Collage Images` pour assembler une mise en page propre.
* Utilisez `Make Image` pour créer un arrière-plan coloré, puis ce bloc si vous avez besoin de marges correspondant à une couleur spécifique.
* Enregistrez automatiquement les résultats paddés en connectant `Padded Image` à `Image Logger` ou `Image Write`.

(hint) Lors de la saisie de la couleur, le système attend les valeurs de pixels dans l'ordre BGR.

## 🛠️ Dépannage

* Si le padding apparaît d'une couleur inattendue, vérifiez que `Color` est fourni au format (Blue, Green, Red) et que chaque valeur est comprise entre 0 et 255.
* Si aucun changement n'est visible, assurez-vous que `Padding Size` est supérieur à zéro et que l'option correcte de `Padding Side` est sélectionnée.
* Lorsque vous combinez de nombreuses images après padding, vérifiez l'alignement final avec `Show Image` pour contrôler l'espacement et la cohérence des bordures.