Génère une image au format GD, vers le navigateur ou un fichier

# imagegd

(PHP 4 >= 4.0.7, PHP 5, PHP 7)

imagegd — Génère une image au format GD, vers le navigateur ou un fichier

### Description

imagegd ( resource `$image` [, mixed `$to` = NULL ] ) : bool

Génère une image GD vers le fichier `to`.

### 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.

### 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
--- | ---
7.2.0 | imagegd() permet maintenant de produire des images TrueColor. Auparavant, elles ont été implicitement converties en palette.
5.4.0 | Ajout de la prise en charge pour le passage d'un flux ressource à `to`.

### Exemples

Exemple #1 Affichage d'une image GD

`<?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
imagegd($im);
// Libération de la mémoire
imagedestroy($im);
?>`

Exemple #2 Sauvegarde d'une image GD

`<?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 GD
// Le format de fichier pour les images GD est .gd, voir http://www.libgd.org/GdFileFormats
imagegd($im, 'simple.gd');
// Libération de la mémoire
imagedestroy($im);
?>`

### Notes

> Note:

> Le format GD est communément utilisé pour autoriser le chargement rapide des parties d'un image. Notez que le format GD est uniquement utilisable dans les applications compatibles GD.

### Voir aussi

- imagegd2() - Génère une image au format GD2, vers le navigateur ou un fichier