Ajouter une bordure colorée à une image : mode d’emploi

À quoi sert l’outil de bordure d’image ?

Ajoutez une bordure ou un cadre à une image lorsque vous souhaitez la distinguer visuellement, créer une marge autour de son contenu ou harmoniser plusieurs visuels. L’outil reçoit les données de l’image sous forme de texte encodé en base64, puis applique une couleur et une largeur de bordure configurables. La largeur proposée par défaut est de 10, tandis que la couleur proposée par défaut est #000000 (noir).

Procédure pour ajouter une bordure

1. Préparez l’image à traiter sous la forme d’une chaîne encodée en base64. Une valeur vide ne permet pas de lancer le traitement : l’image doit donc être fournie et ses données doivent être décodables.

2. Saisissez cette donnée dans le champ prévu pour l’image.

3. Indiquez la largeur souhaitée pour la bordure. Si vous ne la modifiez pas, la valeur utilisée est 10. La largeur fournie est transmise telle quelle à l’opération de bordure ; vérifiez donc qu’elle correspond bien à votre besoin.

4. Choisissez la couleur. La valeur par défaut est #000000. Pour une couleur hexadécimale, utilisez six caractères hexadécimaux après le signe #, par exemple #3366CC. Les signes # placés au début sont retirés avant l’interprétation des six caractères, qui correspondent aux composantes rouge, verte et bleue.

5. Lancez le traitement, puis consultez la sortie. En cas de réussite, récupérez l’image bordée sous forme de texte base64 ainsi que les dimensions de l’image d’origine et de l’image obtenue.

Lire et vérifier le résultat

La sortie réussie contient deux éléments utiles pour vérifier le résultat : l’image modifiée, fournie en texte base64, et les dimensions avant et après traitement. La bordure est donc appliquée à l’image fournie avec la couleur et la largeur indiquées.

Le format d’enregistrement conserve le format d’origine lorsqu’il est disponible. Si aucun format d’origine n’est disponible, l’image traitée est enregistrée au format PNG. Une sortie absente ou un traitement non abouti peut notamment s’expliquer par des données d’image invalides ou impossibles à décoder, une couleur non valide ou une autre exception de traitement. Le fait que l’environnement déclare ne pas utiliser d’accès réseau décrit seulement cette capacité déclarée ; cela ne permet pas de conclure à des conditions particulières de stockage ou de confidentialité.

Exemple pratique

Vous disposez d’une image destinée à une vignette et souhaitez lui ajouter une bordure bleue de largeur 20.

Fournissez cette image en base64, choisissez la couleur hexadécimale #3366CC et une largeur de 20, puis lancez le traitement. Vérifiez que la sortie contient le texte base64 et les deux ensembles de dimensions.

Une sortie réussie contient l’image avec bordure sous forme de texte base64, ainsi que les dimensions de l’image d’origine et de l’image obtenue.

Limites

• Le résultat n’est pas garanti pour une donnée image vide, invalide ou impossible à décoder, une couleur non valide ou une autre exception survenant pendant le traitement.

Erreurs fréquentes

• Une donnée image vide, illisible ou une couleur qui ne fournit pas six caractères hexadécimaux valides peut faire échouer le traitement. Vérifiez que la chaîne base64 correspond bien à une image décodable et saisissez une couleur au format hexadécimal attendu, par exemple #3366CC.

Questions fréquentes

Que reçoit-on après l’ajout de la bordure ?

Lorsque le traitement réussit, la sortie contient l’image bordée en texte base64 et les dimensions de l’image d’origine et du résultat.

Quel format l’image traitée utilise-t-elle ?

Le format d’origine est conservé lorsqu’il est disponible ; sinon, l’image traitée est enregistrée au format PNG.

Quelle couleur de bordure est utilisée par défaut ?

La valeur par défaut est #000000. Vous pouvez la remplacer par une valeur hexadécimale comportant six caractères après le signe #, comme #3366CC.