Comment appliquer des filtres et des effets artistiques aux images

Fournissez les données de l’image en base64, puis choisissez l’un des filtres reconnus pour obtenir une version filtrée en base64. Si aucun filtre n’est indiqué, emboss est utilisé par défaut.

Préparer l’image et choisir un effet

Pour appliquer un effet artistique à une image, fournissez ses données d’image et choisissez un filtre reconnu. L’outil traite l’image fournie, puis renvoie une nouvelle version encodée en base64 lorsque le traitement aboutit. Le filtre utilisé par défaut est emboss si aucun nom de filtre n’est indiqué.

Appliquer le filtre étape par étape

1. Préparez les données de l’image sous forme de contenu encodé en base64. Elles doivent correspondre à une image que le traitement peut ouvrir ; une valeur absente ou vide ne permet pas de lancer le traitement.

2. Sélectionnez un filtre, ou ne renseignez pas ce champ pour utiliser emboss. Les noms disponibles sont blur, contour, detail, edge_enhance, edge_enhance_more, emboss, find_edges, sharpen, smooth et smooth_more. Utilisez l’orthographe exacte de l’un de ces noms.

3. Envoyez les données de l’image avec le nom du filtre choisi. Les données sont décodées depuis le base64, puis l’image est ouverte avant l’application de l’effet.

4. Examinez le résultat retourné. En cas de réussite, récupérez les données de l’image filtrée encodées en base64, ainsi que le nom du filtre sélectionné et les dimensions de l’image. Vous pouvez ensuite décoder ces données pour les utiliser dans votre flux de travail.

5. Si le traitement échoue, vérifiez d’abord que les données ne sont ni absentes ni vides, que le contenu base64 correspond bien à une image ouvrable et que le nom fourni figure dans la liste reconnue. Une erreur peut aussi survenir pendant le décodage, l’ouverture, l’application du filtre ou l’enregistrement de l’image.

Lire le résultat et ses limites

Le résultat réussi contient trois éléments utiles pour la suite : les données filtrées en base64, le nom du filtre retenu et les dimensions de l’image. Le base64 correspond à la nouvelle image, et non à une simple indication du traitement effectué.

Le format de sortie est celui disponible après le traitement. Lorsqu’aucun format exploitable n’est disponible, l’image est enregistrée en PNG. Avec emboss, une image qui n’est pas au format RGB est d’abord convertie en RGB ; ses métadonnées de format d’origine peuvent alors disparaître et la sortie peut utiliser le repli PNG.

Un résultat non réussi signifie que le traitement n’a pas abouti. Il ne permet pas de conclure que le filtre est disponible si le nom est inconnu, ni que l’image est valide si elle ne peut pas être décodée ou ouverte. Corrigez l’entrée, puis relancez le traitement avec un nom de filtre reconnu.

Exemple pratique

Vous souhaitez donner un relief visuel à une photo et choisissez le filtre emboss avant de traiter ses données d’image.

Pour une photo préparée en données base64, fournissez ces données sans laisser le champ vide et sélectionnez emboss. Examinez ensuite la sortie et vérifiez la présence de l’image encodée, du filtre sélectionné et des dimensions.

Un résultat réussi contient les données de l’image filtrée en base64, le nom emboss et les dimensions de l’image traitée.

Limites

• Le traitement peut échouer si les données ne sont pas décodables ou ouvrables comme une image, si le filtre est inconnu ou si une erreur survient pendant le traitement et l’enregistrement.
• Avec emboss sur une image qui n’est pas en RGB, la conversion peut retirer les métadonnées de format d’origine et conduire à une sortie PNG.

Erreurs fréquentes

• Un nom comme outline ou une variante mal orthographiée provoque un échec, car il ne fait pas partie des filtres reconnus. Remplacez-le par l’un des noms disponibles, par exemple find_edges ou contour.

Questions fréquentes

Quelles données faut-il fournir pour appliquer un filtre ?

Oui, si les données d’image ne sont ni absentes ni vides et si elles peuvent être décodées puis ouvertes comme une image. Un contenu non valide peut entraîner un échec.

Quel filtre est utilisé si je n’en choisis pas ?

Le filtre utilisé par défaut est emboss. Vous pouvez aussi sélectionner blur, contour, detail, edge_enhance, edge_enhance_more, find_edges, sharpen, smooth ou smooth_more.

Que contient un résultat réussi ?

La sortie contient les données de l’image filtrée en base64, le nom du filtre sélectionné et les dimensions de l’image.

Pourquoi l’image filtrée peut-elle être renvoyée en PNG ?

Le format disponible après le traitement est conservé lorsque c’est possible ; sinon, la sortie utilise le PNG. Pour emboss sur une image qui n’est pas en RGB, une conversion en RGB peut supprimer les métadonnées de format d’origine et entraîner ce repli PNG.