Affichage de l'image vers le navigateur ou dans un fichier

Description

imagejpeg ( resource $image [, mixed $to = NULL [, int $quality = -1 ]] ) : bool

imagejpeg() crée un fichier JPEG depuis l'image fournie.

Liste de paramètres

image: Une ressource d'image, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
to: Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si défini à NULL, le flux brute de l'image sera affiché directement.
quality: quality est optionnel, et prend des valeurs dans l'intervalle 0 (pire qualité, petit fichier) à 100 (meilleure qualité, gros fichier). Par défaut (-1), utilise la valeur de la qualité IJG par défaut (environ 75).

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Attention

Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne TRUE.

Historique

Version	Description
5.4.0	Ajout du support pour l'utilisation d'un flux resource comme valeur du paramètre `to`.
5.4.0	Interdit le fait de passer une chaîne vide dans le paramètre `to` pour éviter cet argument.

Exemples

Exemple #1 Affichage d'une image JPEG vers le navigateur


<?php
// Création d'une image vide et ajout d'un texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// Définit le contenu de l'en-tête - dans ce cas, image/jpeg
header('Content-Type: image/jpeg');

// Affichage de l'image
imagejpeg($im);

// Libération de la mémoire
imagedestroy($im);
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

Exemple #2 Sauvegarde d'une image JPEG dans un fichier


<?php
// Création d'une image vide et ajout d'un texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'Un texte simple', $text_color);

// Sauvegarde de l'image sous le nom 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');

// Libération de la mémoire
imagedestroy($im);
?>

Exemple #3 Affichage de l'image avec une qualité de 75% vers le navigateur


<?php
// Création d'une image vide et ajout d'un texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'Un texte simple', $text_color);

// Définit le contenu de l'en-tête - dans ce cas,  image/jpeg
header('Content-Type: image/jpeg');

// On ne fournit pas le nom du fichier (utilisation de la valeur NULL),
// puis, on définit la qualité à 75%
imagejpeg($im, NULL, 75);

// Libération de la mémoire
imagedestroy($im);
?>

Notes

Note:
Si vous voulez générer des images JPEG progressives, vous devez activer l'entrelacement à l'aide de la fonction imageinterlace().

Voir aussi

imagepng() - Envoie une image PNG vers un navigateur ou un fichier
imagegif() - Affichage de l'image vers le navigateur ou dans un fichier
imagewbmp() - Affichage de l'image vers le navigateur ou dans un fichier
imageinterlace() - Active ou désactive l'entrelacement
imagetypes() - Retourne les types d'images supportés par la version courante de PHP