gdImageCopyGaussianBlurred |
Copie d'image floue gaussienne |
| LibGD |
Syntaxe
|
gdImagePtr gdImageCopyGaussianBlurred(gdImagePtr src, unsigned int radius, float sigma);
|
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. |
Description
Cette fonction permet d'appliquer un flou gaussien à une image en créant une copie.
Remarques
- 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.
- 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 : Mercredi, le 29 Janvier 2025
