Les entrées/sorties WebP
Le format WebP est un format d'image moderne développé par Google, conçu pour offrir des images de haute qualité tout en étant plus léger que les formats traditionnels comme JPEG ou PNG. Dans la bibliothèque LibGD, le module "WebP IO" permet de charger et d'enregistrer des images au format WebP en utilisant diverses fonctions optimisées pour la gestion de ce format. Le support du WebP au sein de LibGD permet aux développeurs de manipuler facilement des images WebP, que ce soit pour la création d'images à la volée, le traitement d'images existantes, ou pour l'intégration de WebP dans des systèmes web où l'efficacité de l'entreposage et de la bande passante est cruciale.
Les fonctions liées à "WebP IO" dans LibGD, comme gdImageCreateFromWebP ou gdImageCreateFromWebPEx, permettent de lire des fichiers WebP et de les convertir en objets gdImagePtr, une structure de données interne utilisée par LibGD pour représenter les images. Ces fonctions prennent en charge la lecture de fichiers WebP, décodant les données du fichier WebP et les entreposant dans un format que LibGD peut manipuler. Cela facilite la conversion d'images WebP en d'autres formats ou leur traitement au sein d'une application sans avoir à se soucier de la gestion complexe du format WebP en interne.
D'autre part, les fonctions telles que gdImageWebP et gdImageWebPEx permettent d'exporter des images en format WebP. Ces fonctions offrent des options pour spécifier la qualité de compression, et la fonction gdImageWebPEx fournit un contrôle supplémentaire, permettant de définir des paramètres comme le niveau de compression ou l'utilisation de la compression avec ou sans transparence. Cela permet aux utilisateurs de WebP IO de LibGD de générer des images WebP optimisées pour le web, avec une bonne balance entre taille de fichier et qualité visuelle.
Le rôle des fonctions gérant WebP IO est d'offrir un moyen simple, flexible et performant de travailler avec des images WebP dans des applications utilisant LibGD. Avec une large adoption de WebP dans les navigateurs modernes, les outils et bibliothèques qui supportent ce format deviennent essentiels pour le développement d'applications web rapides et efficaces. En résumé, "WebP IO" dans LibGD permet de charger, manipuler et sauvegarder des images WebP avec une efficacité maximale, simplifiant ainsi l'intégration de ce format dans les projets de traitement d'images et de gestion de contenu multimédia.
Les fonctions
| Nom | Description |
|---|---|
| gdImageCreateFromWebp | La fonction gdImageCreateFromWebp est utilisée pour charger des images en couleurs vraies depuis des fichiers au format WebP. |
| gdImageCreateFromWebpPtr | Voir gdImageCreateFromWebp. |
| gdImageCreateFromWebpCtx | Voir gdImageCreateFromWebp. |
| gdImageWebpCtx | Écrit l'image sous forme de données WebP via un gdIOCtx. |
| gdImageWebpEx | gdImageWebpEx exporte l'image spécifiée vers le fichier spécifié au format WebP. |
| gdImageWebp | Variante de gdImageWebpEx utilisant la qualité par défaut (-1). |
| gdImageWebpPtr | Voir gdImageWebpEx. |
| gdImageWebpPtrEx | Voir gdImageWebpEx. |
gdImageCreateFromWebp
| gdImagePtr gdImageCreateFromWebp(FILE *inFile); |
gdImageCreateFromWebp est appelé pour charger des images en couleurs vraies à partir de fichiers au format WebP. Appelez gdImageCreateFromWebp avec un pointeur déjà ouvert vers un fichier contenant l'image souhaitée. gdImageCreateFromWebp renvoie un gdImagePtr vers la nouvelle image en couleurs vraies, ou NULL s'il est impossible de charger l'image (le plus souvent parce que le fichier est corrompu ou ne contient pas d'image WebP). gdImageCreateFromWebp ne ferme pas le fichier.
Vous pouvez inspecter les membres sx et sy de l'image pour déterminer sa taille. L'image doit éventuellement être détruite à l'aide de gdImageDestroy.
L'image renvoyée est toujours une image en couleurs vraies.
Variantes
gdImageCreateFromWebpPtr crée une image à partir de données WebP déjà en mémoire.
gdImageCreateFromWebpCtx lit ses données via les pointeurs de fonction dans une structure gdIOCtx.
Paramètre
| Nom | Description |
|---|---|
| infile | Ce paramètre permet d'indiquer le pointeur de fichier d'entrée. |
Retour
| Valeur | Description |
|---|---|
| NULL | Une erreur s'est produit. |
| Pointeur | Un pointeur vers la nouvelle image en vraies couleurs. Celui-ci devra être détruit avec gdImageDestroy une fois qu'il ne sera plus nécessaire. |
gdImageCreateFromWebpPtr
| gdImagePtr gdImageCreateFromWebpPtr(int size, void *data); |
Voir ImageCreateFromWebp.
Paramètre
| Nom | Description |
|---|---|
| size | Ce paramètre permet d'indiquer la taille des données WebP en octets. |
| data | Ce paramètre permet d'indiquer un pointeur vers des données WebP. |
gdImageCreateFromWebpCtx
| gdImagePtr gdImageCreateFromWebpCtx(gdIOCtx *infile); |
Voir gdImageCreateFromWebp.
gdImageWebpCtx
| void gdImageWebpCtx(gdImagePtr im, gdIOCtx *outfile, int quality); |
Écrivez l'image sous forme de données WebP via un gdIOCtx. Voir gdImageWebpEx pour plus de détails.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image à écrire. |
| outfile | Ce paramètre permet d'indiquer le fichier de sortie. |
| quality | Ce paramètre permet d'indiquer la qualité de l'image. |
Retour
Rien
gdImageWebpEx
| void gdImageWebpEx(gdImagePtr im, FILE *outFile, int quality); |
gdImageWebpEx génère l'image spécifiée dans le fichier spécifié au format WebP. 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. gdImageWebpEx ne ferme pas le fichier ; votre code doit le faire.
Si la qualité est -1, une valeur de qualité raisonnable (devant donner un bon compromis qualité/taille générale dans la plupart des situations) est utilisée. Sinon, la qualité doit être une valeur comprise entre 0 et 100, les valeurs de qualité supérieures impliquant généralement à la fois une qualité supérieure et des tailles d'image plus grandes.
Si la qualité est supérieure ou égale à gdWebpLossless, l'image sera écrite au format WebP sans perte.
Variantes
gdImageWebpCtx entrepose l'image à l'aide d'une structure gdIOCtx.
gdImageWebpPtrEx entrepose l'image dans la RAM.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer que l'image à sauvegarder. |
| outFile | Ce paramètre permet d'indiquer le pointeur FILE vers lequel écrire. |
| quality | Ce paramètre permet d'indiquer la qualité de compression (0 à 100). |
Retour
Rien
gdImageWebp
| void gdImageWebp(gdImagePtr im, FILE *outFile); |
Variante de gdImageWebpEx utilisant la qualité par défaut (-1).
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. |
Retour
Rien
gdImageWebpPtr
| void * gdImageWebpPtr(gdImagePtr im, int *size); |
Voir gdImageWebpEx.
gdImageWebpPtrEx
| void * gdImageWebpPtrEx(gdImagePtr im, int *size, int quality); |
Voir gdImageWebpEx.