Les filtres d'image
Les filtres d'image de LibGD permettent d'appliquer des effets visuels et des transformations aux images de manière simple et efficace. Grâce
à ces fonctionnalités, les développeurs peuvent modifier la luminosité, le contraste, la saturation, ou encore appliquer des effets tels que le flou, la netteté ou la conversion
en niveaux de gris. Ces filtres sont idéaux pour des applications Web ou de bureau nécessitant une manipulation d'images en temps réel, comme les éditeurs d'images en ligne, les
systèmes de gestion de contenu, ou encore les outils de génération de miniatures.
Fonctionnement des filtres avec gdImageFilter
L'application des filtres dans LibGD repose sur la fonction clef gdImageFilter. Cette fonction accepte en paramètre une image GD et
un filtre prédéfini, ainsi que d'éventuels paramètres additionnels pour ajuster les résultats. Par exemple, pour appliquer un flou, on peut utiliser le filtre GD_FILTER_GAUSSIAN_BLUR,
tandis que pour augmenter la netteté, on peut utiliser GD_FILTER_SHARPEN. Cette approche rend l'utilisation des filtres intuitive, car elle repose sur des options préconfigurées tout
en offrant une certaine flexibilité grâce aux paramètres ajustables.
Utilisation pratique des filtres courants
Les filtres courants incluent le réglage de la luminosité (GD_FILTER_BRIGHTNESS), qui permet d'éclaircir ou d'assombrir une image, et le filtre de
contraste (GD_FILTER_CONTRAST), ajustant la différence entre les zones claires et sombres. Pour des effets plus artistiques, des filtres comme GD_FILTER_EDGEDETECT ou
GD_FILTER_EMBOSS peuvent être utilisés pour détecter les contours ou donner un effet en relief à une image. Chaque filtre est conçu pour être appliqué en quelques lignes
de code, rendant leur intégration rapide dans un projet existant.
Avantages et limites des filtres dans LibGD
Les filtres d'image de LibGD offrent un bon équilibre entre performance et facilité d'utilisation. Ils sont rapides et adaptés à des tâches
courantes de traitement d'image, notamment sur des serveurs où les ressources peuvent être limitées. Cependant, ces filtres ne remplacent pas les capacités avancées des logiciels de
retouche photo comme Photoshop. Par exemple, les filtres disponibles sont souvent basiques et ne permettent pas des ajustements
complexes ou des traitements par couches. Malgré cela, LibGD reste une solution performante et fiable pour les besoins de traitement d'image en temps réel.
Les fonctions
Voici les fonctions proposé par LibGD pour les filtres d'images :
| Nom |
Description |
| gdImageScatter |
Cette fonction permet d'ajouter un effet de dispersion aléatoire à une image en déplaçant certains pixels dans un voisinage donné pour créer une apparence "éparpillée". |
| gdImageScatterColor |
Cette fonction permet d'appliquer une dispersion similaire à gdImageScatter, mais avec un contrôle supplémentaire sur les couleurs affectées. |
| gdImageScatterEx |
Cette fonction est une version étendue de gdImageScatter permettant un contrôle précis des paramètres, comme l'intervalle de dispersion ou la probabilité d'éparpillement. |
| gdImagePixelate |
Cette fonction permet de pixeliser l'image en regroupant les pixels en blocs carrés avec une couleur moyenne ou dominante. |
| gdImageNegate |
Cette fonction permet d'inverser les couleurs d'une image, transformant les valeurs des canaux pour créer un effet négatif. |
| gdImageGrayScale |
Cette fonction permet de convertir une image en niveaux de gris en utilisant une pondération standard des canaux de couleur. |
| gdImageBrightness |
Cette fonction permet de modifier la luminosité d'une image en éclaircissant ou en assombrissant les pixels. |
| gdImageContrast |
Cette fonction permet d'ajuster le contraste d'une image en modifiant la différence entre les zones sombres et claires. |
| gdImageColor |
Cette fonction permet de changer individuellement les valeurs des canaux de couleur (rouge, vert, bleu, alpha) d'une image. |
| gdImageConvolution |
Cette fonction permet d'appliquer une matrice de convolution pour réaliser des transformations comme le flou, le renforcement des contours, ou d'autres effets basés sur les pixels environnants. |
| gdImageSelectiveBlur |
Cette fonction permet d'appliquer un flou sélectif, en conservant les détails dans certaines zones respectant des critères définis. |
| gdImageEdgeDetectQuick |
Cette fonction permet d'effectuer une détection rapide des contours en mettant en évidence les zones où les couleurs changent brusquement. |
| gdImageGaussianBlur |
Cette fonction permet d'appliquer un flou gaussien à l'image avec un rayon de 1 pour lisser les détails tout en conservant une certaine netteté. |
| gdImageEmboss |
Cette fonction permet d'ajouter un effet d'embossage (relief) à l'image en simulant des ombres et des lumières pour donner de la profondeur. |
| gdImageMeanRemoval |
Cette fonction permet d'appliquer un effet de suppression de la moyenne, souvent utilisé pour accentuer les bords et texturer l'image. |
| gdImageSmooth |
Cette fonction permet de lisser une image en réduisant le bruit ou les variations abruptes entre les pixels adjacents. |
| gdImageCopyGaussianBlurred |
Cette fonction permet de créer une copie floutée de l'image source en utilisant un algorithme de flou gaussien avec des paramètres spécifiques. |
Cette fonction permet d'ajouter un effet de dispersion aléatoire à une image en déplaçant certains pixels dans un voisinage donné pour créer une apparence "éparpillée".
|
int gdImageScatterColor(gdImagePtr im, int sub, int plus, int colors[], unsigned int num_colors);
|
Cette fonction permet d'appliquer une dispersion similaire à gdImageScatter, mais avec un contrôle supplémentaire sur les couleurs affectées.
Cette fonction est une version étendue de gdImageScatter permettant un contrôle précis des paramètres, comme l'intervalle de dispersion ou la probabilité d'éparpillement.
|
int gdImagePixelate(gdImagePtr im, int block_size, const unsigned int mode);
|
Cette fonction permet de pixeliser l'image en regroupant les pixels en blocs carrés avec une couleur moyenne ou dominante.
Cette fonction permet d'inverser une image.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Cette fonction permet de convertir une image en niveaux de gris. Les composantes rouge, verte et bleue de chaque pixel sont remplacées
par leur somme pondérée en utilisant les mêmes coefficients que le calcul de luminance (Y') REC.601. Les composantes alpha sont conservées. Pour les images en palette, le
résultat peut différer en raison des limitations de la palette.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Cette fonction permet de modifier la luminosité d'une image.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
| brightness |
Ce paramètre permet d'indiquer la valeur à ajouter aux canaux de couleur de tous les pixels. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
Cette fonction permet de modifier le contraste d'une image.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
| contrast |
Ce paramètre permet d'indiquer une valeur de réglage du contraste. Les valeurs négatives augmentent le contraste, les valeurs positives le diminuent. Plus la valeur absolue est élevée, plus l'effet est fort. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
|
int gdImageColor(gdImagePtr src, const int red, const int green, const int blue, const int alpha);
|
Cette fonction permet de modifier les valeurs des canaux d'une image.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
| red |
Ce paramètre permet d'indiquer la valeur à ajouter au canal rouge de tous les pixels. |
| green |
Ce paramètre permet d'indiquer la valeur à ajouter au canal vert de tous les pixels. |
| blue |
Ce paramètre permet d'indiquer la valeur à ajouter au canal bleu de tous les pixels. |
| alpha |
Ce paramètre permet d'indiquer la valeur à ajouter au canal alpha de tous les pixels. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
|
int gdImageConvolution(gdImagePtr src, float filter[3][3], float filter_div, float offset);
|
Cette fonction permet d'appliquer une matrice de convolution à une image. En fonction de la matrice, une large gamme d'effets peut être obtenue, par
exemple le flou, la netteté, le gaufrage et la détection des contours.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
| filter |
Ce paramètre permet d'indiquer la matrice de convolution 3x3. |
| filter_div |
Ce paramètre permet d'indiquer la valeur par laquelle diviser les valeurs de canal alambiquées. |
| offset |
Ce paramètre permet d'indiquer la valeur à ajouter aux valeurs de canal alambiquées. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
Cette fonction permet d'appliquer un flou sélectif, en conservant les détails dans certaines zones respectant des critères définis.
Cette fonction permet la détection des contours d'une image.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer une image. |
Retour
| Valeur |
Description |
| Entier |
Non nul en cas de succès, zéro en cas d'échec. |
Voir également
gdImageGaussianBlur effectue un flou gaussien de rayon 1 sur l'image. L'image est modifiée sur place.
Remarque : vous souhaiterez presque certainement utiliser gdImageCopyGaussianBlurred à la place, car il vous permet de modifier la taille de
votre noyau et la valeur sigma. Les futures versions de cette fonction pourraient revenir à l'appeler au lieu de gdImageConvolution, ce qui entraînerait des modifications
subtiles, alors soyez prévenu.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image à flouter. |
Retour
| Valeur |
Description |
| GD_FALSE (0) |
En cas d'échec. |
| GD_TRUE (1) |
En cas de succès. |
Cette fonction permet d'embosser une image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
Retour
| Valeur |
Description |
| Entier |
Non nul en cas de succès, zéro en cas d'échec. |
Voir également
Cette fonction permet d'indiquer la suppression moyenne d'une image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
Cette fonction permet de lisser une image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| weight |
Ce paramètre permet d'indiquer la force du lissage. |
Retour
| Valeur |
Description |
| Entier |
Non zéro en cas de succès, zéro en cas d'échec. |
Voir également
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer un pointeur vers l'image source (de type gdImagePtr) qui sera floutée. |
| radius |
Ce paramètre permet d'indiquer le rayon de l'effet de flou gaussien (pas le diamètre - l'intervalle est 2*rayon + 1). Il définit la portée du flou autour de chaque pixel. |
| sigma |
Ce paramètre permet d'indiquer la valeur de sigma pour l'algorithme de flou gaussien. Un sigma plus grand produit un flou plus diffus. La valeur sigma ou une valeur <= 0,0 pour utiliser la valeur par défaut calculée. |
Retour
| Valeur |
Description |
| Pointeur |
La nouvelle image ou NULL si une erreur s'est produite. Le résultat est toujours truecolor. |
Cette fonction renvoie une copie de l'image source src floue selon les paramètres à l'aide de l'algorithme de flou gaussien.
radius est un rayon, pas un diamètre, donc un rayon de 2 (par exemple) floutera une région de 5 pixels de large (2 au centre, 1 pour le
centre lui-même et 2 autres jusqu'à l'autre bord).
sigma représente la «grossesse» de la courbe (plus bas == plus gros). Si sigma est inférieur ou égal à 0, gdImageCopyGaussianBlurred
l'ignore et calcule à la place une valeur « optimale ». Sachez que les futures versions de cette fonction peuvent calculer sigma différemment.
L'image résultante est toujours en vraies couleurs.
Plus de détails
Un flou gaussien est généré en remplaçant les valeurs de couleur de chaque pixel par la moyenne des couleurs des pixels environnants. Cette région est
un cercle dont le rayon est donné par le paramètre radius. Ainsi, un rayon plus grand produira une image plus floue.
Cette moyenne n'est pas une simple moyenne des valeurs. Au lieu de cela, les valeurs sont pondérées à l'aide de la fonction gaussienne (en gros une
courbe en cloche centrée autour du pixel de destination), ce qui lui donne beaucoup plus d'influence sur le résultat que ses voisins. Ainsi, une courbe plus épaisse donnera plus
de poids au pixel central et rendra l'image moins floue ; des valeurs sigma plus faibles produiront des courbes plus plates.
Actuellement, gdImageCopyGaussianBlurred calcule le sigma par défaut comme suit :
Notez cependant que nous nous réservons le droit de modifier ce ratio si nous trouvons un meilleur ratio. Si vous avez absolument besoin de la valeur
sigma actuelle, vous devez la définir vous-même.
Exemple
- FILE *in;
- gdImagePtr result, src;
-
- in = fopen("foo.png", "rb");
- src = gdImageCreateFromPng(in);
-
- result = gdImageCopyGaussianBlurred(im, src->sx / 10, -1.0);
Dernière mise à jour : Mardi, le 8 octobre 2024
