# imagegif

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Description

imagegif(GdImage `$image`, resource|string|null `$file` = `null`): bool

imagegif() crée un fichier image GIF dans `file` d'après l'image `image`. L'argument `image` est un identifiant valide retourné par la fonction imagecreate() ou les fonctions `imagecreatefrom*`.

Le format de l'image sera GIF87a, à moins que l'image n'ait une couleur transparente (mise en place grâce à la fonction imagecolortransparent())), ce qui fera qu'elle sera au format GIF89a.

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

### 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
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Affichage d'une image en utilisant imagegif()

`<?php
// Création d'une image
$im = imagecreatetruecolor(100, 100);
// Définit l'arrière-plan en blanc
imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);
// Dessine un texte dans l'image
imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);
// Affiche l'image sur le navigateur
header('Content-Type: image/gif');
imagegif($im);
?>`

Exemple #2 Conversion d'une image PNG en GIF, en utilisant imagegif()

`<?php
// Chargement de l'image PNG
$png = imagecreatefrompng('./php.png');
// Sauvegarde de l'image en GIF
imagegif($png, './php.gif');
// C'est fait !
echo 'Conversion avec succès de l\'image PNG en GIF !';
?>`

### Notes

> Note:

> Le code suivant vous permet d'écrire des scripts PHP plus portables : le type de GD est automatiquement détecté. Il remplace la séquence `header ("Content-Type: image/gif"); ImageGif($im);` par un code plus souple :

> `<?php
> // Création d'une image
> $im = imagecreatetruecolor(100, 100);
> // On fait quelques opérations sur l'image ici...
> // Gestion de l'affichage
> if(function_exists('imagegif'))
> {
> // Pour GIF
> header('Content-Type: image/gif');
> imagegif($im);
> }
> elseif(function_exists('imagejpeg'))
> {
> // Pour JPEG
> header('Content-Type: image/jpeg');
> imagejpeg($im, NULL, 100);
> }
> elseif(function_exists('imagepng'))
> {
> // Pour PNG
> header('Content-Type: image/png');
> imagepng($im);
> }
> elseif(function_exists('imagewbmp'))
> {
> // Pour WBMP
> header('Content-Type: image/vnd.wap.wbmp');
> imagewbmp($im);
> }
> else
> {
> die('Aucun support sur ce serveur PHP n\'a été trouvé');
> }
> ?>`

> Note:

> Vous pouvez utiliser la fonction imagetypes() au lieu de function_exists() pour vérifier la présence des différents formats d'images supportés.:

> `<?php
> if(imagetypes() & IMG_GIF)
> {
> header('Content-Type: image/gif');
> imagegif($im);
> }
> elseif(imagetypes() & IMG_JPG)
> {
> /* ... etc. */
> }
> ?>`

### Voir aussi

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