gdImageGif |
Image GIF |
|---|---|
| LibGD | |
Syntaxe
| void gdImageGif(gdImagePtr im, FILE *outFile); |
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image à écrire. |
| outFile | Ce paramètre permet d'indiquer le pointeur FILE dans lequel écrire l'image. |
Retour
Rien
Description
Cette fonction permet de sauvegarder une image au format GIF dans un fichier.
Remarques
- gdImageGif génère l'image spécifiée dans le fichier spécifié au format GIF. Le fichier doit être ouvert pour l'écriture binaire. (Sous MS-DOS et toutes les versions de Windows, il est important d'utiliser «wb» plutôt que simplement «w» comme mode lors de l'ouverture du fichier ; sous Unix, il n'y a aucune pénalité pour cela). gdImageGif ne ferme pas le fichier ; votre code doit le faire.
- Le format GIF ne prend pas en charge les couleurs vraies ; les images GIF peuvent contenir un maximum de 256 couleurs. Si l'image à écrire est une image en couleurs vraies, comme celles créées avec gdImageCreateTrueColor ou chargées à partir d'un fichier image JPEG ou PNG en couleurs vraies, une image temporaire basée sur une palette sera automatiquement créée en interne à l'aide de la fonction gdImageCreatePaletteFromTrueColor. Les pixels de l'image d'origine ne sont pas modifiés. Cette conversion produit des palettes de haute qualité mais nécessite un peu de temps de microprocesseur. Si vous convertissez régulièrement des couleurs vraies en palette de cette manière, vous devriez envisager de créer votre image en tant qu'image basée sur une palette en premier lieu.
Exemple
- gdImagePtr im;
- int black, white;
- FILE *out;
- /* Créer l'image */
- im = gdImageCreate(100, 100);
- /* Attribuer l'arrière-plan */
- white = gdImageColorAllocate(im, 255, 255, 255);
- /* Attribuer la couleur du dessin */
- black = gdImageColorAllocate(im, 0, 0, 0);
- /* Dessiner un rectangle */
- gdImageRectangle(im, 0, 0, 99, 99, black);
- /* Ouvrir le fichier de sortie en mode binaire */
- out = fopen("rect.gif", "wb");
- /* Écrire un GIF */
- gdImageGif(im, out);
- /* Fermer le fichier */
- fclose(out);
- /* Détruire l'image */
- gdImageDestroy(im);
Variantes
- gdImageGifCtx génère l'image via une structure gdIOCtx.
- gdImageGifPtr entrepose l'image dans un grand tableau d'octets.
Dernière mise à jour : Mercredi, le 29 Janvier 2025