imagejpeg
(PHP 4, PHP 5)
imagejpeg — Envoie une image JPEG vers un navigateur ou un fichier
Description
imagejpeg() cr�e un fichier JPEG depuis l'image fournie.
Liste de param�tres
- image
-
Une ressource d'image, retourn� par une des fonctions de cr�ation d'images, comme imagecreatetruecolor().
- filename
-
Le chemin vers le fichier de sauvegarde. S'il n'est pas d�fini ou s'il vaut NULL, le flux brut de l'image sera affich� directement.
Pour �viter de fournir cet argument afin de fournir l'argument quality , utilisez une valeur NULL.
- quality
-
quality est optionnel, et prend des valeurs enti�res de 0 (pire qualit�, petit fichier) et 100 (meilleure qualit�, gros fichier). Par d�faut, la valeur est celle de la qualit� IJG (75).
Valeurs de retour
Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.
Exemples
Exemple #1 Affichage d'une image JPEG
<?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
<?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%
<?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: Le support JPEG n'est disponible que si PHP a �t� compil� avec GD-1.8 ou sup�rieur.
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() - Envoie une image GIF vers un navigateur ou un fichier
- imagewbmp() - Affiche une image WBMP
- imageinterlace() - Active ou d�sactive l'entrelacement
- imagetypes() - Retourne les types d'images support�s par la version courante de PHP