gdImageJpeg |
Image JPEG |
|---|---|
| LibGD | |
Syntaxe
| void gdImageJpeg(gdImagePtr im, FILE *outFile, int quality); |
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image à sauvegarder. |
| outFile | Ce paramètre permet d'indiquer le pointeur FILE vers lequel écrire. |
| quality | Ce paramètre permet de qualité de compression (0 à 95, 0 signifie utiliser la valeur par défaut). |
Retour
Rien
Description
Cette fonction permet d'enregistrer une image au format JPEG dans un fichier.
Remarques
- gdImageJpeg génère l'image spécifiée dans le fichier spécifié au format JPEG. 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. gdImageJpeg ne ferme pas le fichier ; votre code doit le faire.
- Si la qualité est négative, la valeur de qualité JPEG par défaut d'IJG (devant donner un bon compromis qualité/taille générale dans la plupart des situations) est utilisée. Sinon, pour des raisons pratiques, la qualité doit être une valeur comprise entre 0 et 95, les valeurs de qualité supérieures impliquant généralement à la fois une qualité supérieure et des tailles d'image plus grandes.
- Si vous avez défini l'entrelacement d'images à l'aide de gdImageInterlace, cette fonction interprétera cela comme signifiant que vous souhaitez générer un JPEG progressif. Certains programmes (par exemple, les navigateurs Web) peuvent afficher les JPEG progressifs de manière incrémentielle; cela peut être utile lors de la navigation sur une liaison de communication relativement lente, par exemple. Les fichiers JPEG progressifs peuvent également être légèrement plus petits que les fichiers JPEG séquentiels (non progressifs).
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.jpg", "wb");
- /* Écrire au format JPEG en utilisant la qualité par défaut */
- gdImageJpeg(im, out, -1);
- /* Fermer le fichier */
- fclose(out);
- /* Détruire l'image */
- gdImageDestroy(im);
Variantes
gdImageJpegCtx entrepose l'image à l'aide d'une structure gdIOCtx.
gdImageJpegPtr entrepose l'image dans la RAM.
Dernière mise à jour : Mercredi, le 29 Janvier 2025