gdImagePngEx |
Image PNG étendue |
|---|---|
| LibGD | |
Syntaxe
| void gdImagePngEx(gdImagePtr im, FILE * outFile, int level); |
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image à écrire. |
| outFile | Ce paramètre permet d'indiquer l'objet de sortie FILE*. |
| level | Ce paramètre permet d'indiquer le niveau de compression : 0 → aucun, 1 à 9 → niveau, -1 → par défaut. |
Retour
Rien
Description
Cette fonction permet d'enregistrer une image au format PNG avec des options supplémentaires.
Remarques
- gdImagePngEx génère l'image spécifiée dans le fichier spécifié au format PNG. Le fichier doit être ouvert pour l'écriture. 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, et sous Unix, il n'y a aucune pénalité pour cela. gdImagePngEx ne ferme pas le fichier ; votre code doit le faire.
- De plus, gdImagePngEx permet de spécifier le niveau de compression. Un niveau de compression de 0 signifie «aucune compression». Un niveau de compression de 1 signifie «compressé, mais aussi rapidement que possible». Un niveau de compression de 9 signifie «compressé autant que possible pour produire le fichier le plus petit possible». Un niveau de compression de -1 utilisera le niveau de compression par défaut au moment où zlib a été compilé sur votre système.
Exemple
- gdImagePtr im;
- int black, white;
- FILE *out;
-
- im = gdImageCreate(100, 100); /* Créer l'image */
- white = gdImageColorAllocate(im, 255, 255, 255); /* Contexte d'allocation */
- black = gdImageColorAllocate(im, 0, 0, 0); /* Attribuer la couleur du dessin */
- gdImageRectangle(im, 0, 0, 99, 99, black); /* Dessiner un rectangle */
- out = fopen("rect.png", "wb"); /* Ouvrir le fichier de sortie (binaire) */
- gdImagePngEx(im, out, 9); /* Écrire en PNG, compression maximale */
- fclose(out); /* Fermer le fichier */
- gdImageDestroy(im); /* Détruire l'image */
Variantes
gdImagePng équivaut à appeler gdImagePngEx avec une compression de -1.
gdImagePngCtx et gdImagePngCtxEx écrivent via un gdIOCtx au lieu d'un descripteur de fichier.
gdImagePngPtr et gdImagePngPtrEx entreposent le fichier image en mémoire.
Dernière mise à jour : Mercredi, le 29 Janvier 2025