(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Génère une image au format GD2, vers le navigateur ou un fichier
Description
imagegd2(
GdImage
$image
,
?string
$file
=
null
,
int
$chunk_size
= 128,
int
$mode
=
IMG_GD2_RAW
): bool
Liste de paramètres
-
image
-
Un objet GdImage, retournée par une des fonctions de
création d'images, comme imagecreatetruecolor().
-
file
-
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 non-défini ou null
, le flux brute de l'image sera affiché directement.
-
chunk_size
-
Taille de la pièce.
-
mode
-
Soit IMG_GD2_RAW
, soit
IMG_GD2_COMPRESSED
. Par défaut, vaut
IMG_GD2_RAW
.
Valeurs de retour
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
AttentionToutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne true
.
Historique
Exemples
Exemple #1 Affichage d'une image GD2
<?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);
// Affichage de l'image
imagegd2($im);
// Libération de la mémoire
imagedestroy($im);
?>
Exemple #2 Sauvegarde d'une image GD2
<?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 GD2
// Le format de fichier pour les images GD2 est .gd2, voir http://www.libgd.org/GdFileFormats
imagegd2($im, 'simple.gd2');
// Libération de la mémoire
imagedestroy($im);
?>
Notes
Note:
Le format GD2 est communément utilisé pour charger rapidement les
parties d'une image. Notez que le format GD2 est uniquement utilisable
dans les applications compatibles GD2.
Avertissement
Les formats d'image GD et GD2 sont des formats d'images propriétaire de libgd.
Ils doivent être considérés obsolète, et devraient seulement
être utilisé lors du développement et la phase de test.
Voir aussi
- imagegd() - Génère une image au format GD, vers le navigateur ou un fichier