Applique un filtre à une image

Description

bool imagefilter ( resource $image , int $filtertype [, int $arg1 [, int $arg2 [, int $arg3 [, int $arg4 ]]]] )

imagefilter() applique le filtre filtertype à l'image en utilisant les paramètres args1 , args2 et args3 lorsque cela est nécessaire.

Liste de paramètres

image

Une ressource d'image, retourné par une des fonctions de création d'images, comme imagecreatetruecolor().

filtertype

Le paramètre filtertype peut prendre l'une des valeurs suivantes :

IMG_FILTER_NEGATE : renverse toutes les couleurs de l'image.
IMG_FILTER_GRAYSCALE : convertit l'image en grayscale.
IMG_FILTER_BRIGHTNESS : modifie la luminosité de l'image. Utilisez le paramètre args1 pour définir la luminosité.
IMG_FILTER_CONTRAST : modifie le contraste de l'image. Utilisez le paramètre args1 pour définir le contraste.
IMG_FILTER_COLORIZE : Identique au paramètre IMG_FILTER_GRAYSCALE excepté que vous pouvez spécifier une couleur. Utilisez trois arguments séparés dans les paramètres args1 , args2 et args3 sous la forme red , blue , green et arg4 pour le canal alpha . L'intervalle pour chaque couleur est 0 - 255.
IMG_FILTER_EDGEDETECT : utilise la détection des bords pour les mettre en évidence dans l'image.
IMG_FILTER_EMBOSS : grave l'image en relief.
IMG_FILTER_GAUSSIAN_BLUR : brouille l'image en utilisant la méthode gaussienne.
IMG_FILTER_SELECTIVE_BLUR : brouille l'image.
IMG_FILTER_MEAN_REMOVAL : son utilisation signifie le déplacement pour réaliser un effet "peu précis".
IMG_FILTER_SMOOTH : rend l'image lissoir (smooth). Utilisez le paramètre args1 pour définir le degré de lissoir.

arg1

arg2

arg3

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Historique

Version	Description
5.2.5	Le support du canal Alpha pour la constante `IMG_FILTER_COLORIZE` a été ajouté.

Exemples

Exemple #1 Exemple avec imagefilter()


<?php
$im = imagecreatefrompng('dave.png');
if ($im && imagefilter($im, IMG_FILTER_GRAYSCALE)) {
    echo 'Image convertie en grayscale.';
    imagepng($im, 'dave.png');
} else {
    echo 'La convertion en grayscale a échoué.';
}

imagedestroy($im);
?>

Exemple #2 Exemple avec imagefilter()


<?php
$im = imagecreatefrompng('sean.png');
if ($im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) {
    echo 'La luminosité de l\'image a été modifiée.';
    imagepng($im, 'sean.png');
} else {
    echo 'Echec lors de la modification de la luminosité.';
}

imagedestroy($im);
?>

Exemple #3 Exemple avec imagefilter()


<?php
$im = imagecreatefrompng('philip.png');

/* R, G, B, donc 0, 255, 0 correspond au vert */
if ($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) {
    echo 'L\'image a été ombragée en vert avec succès.';
    imagepng($im, 'philip.png');
} else {
    echo 'Echec lors de la modification de l\'ombrage.';
}

imagedestroy($im);
?>

Notes

Note: Cette fonction n'est disponible que si PHP est compilé avec la version embarquée de la bibliothèque GD.

Voir aussi

imageconvolution()