Les entrées/sorties AVIF
LibGD ne prend pas en charge directement le format AVIF (AV1 Image File Format), mais il existe des moyens d'intégrer ce format dans un projet utilisant cette bibliothèque en recourant à des bibliothèques tierces comme libavif. AVIF est un format d'image récent et moderne utilisant la compression du codec vidéo AV1. Ce format permet de compresser les images à un taux très élevé tout en maintenant une qualité exceptionnelle. Il est particulièrement adapté aux applications Web où les tailles d'images doivent être réduites sans perte de qualité perceptible.
Lisez et écrivez des images AVIF à l'aide de libavif (https://github.com/AOMediaCodec/libavif). Actuellement, le seul profil ICC qu'il prenne en charge est sRGB. Comme c'est celui utilisé par les navigateurs Web, c'est suffisant pour l'instant.
Les fonctions
| Nom | Description |
|---|---|
| gdImageCreateFromAvif | gdImageCreateFromAvif est appelé pour charger des images en vraies couleurs à partir de fichiers au format AVIF. |
| gdImageCreateFromAvifPtr | Voir gdImageCreateFromAvif. |
| gdImageCreateFromAvifCtx | Voir gdImageCreateFromAvif. |
| gdImageAvifEx | gdImageAvifEx génère l'image spécifiée dans le fichier spécifié au format AVIF. |
gdImageCreateFromAvif
| gdImagePtr gdImageCreateFromAvif(FILE *infile); |
gdImageCreateFromAvif est appelé pour charger des images en couleurs vraies à partir de fichiers au format AVIF. Appelez gdImageCreateFromAvif avec un pointeur déjà ouvert vers un fichier contenant l'image souhaitée. gdImageCreateFromAvif 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 AVIF). gdImageCreateFromAvif ne ferme pas le fichier.
Cette fonction crée une structure gdIOCtx à partir du pointeur de fichier qui lui est passé. Elle s'appuie ensuite sur gdImageCreateFromAvifCtx pour effectuer le véritable travail de décodage. Si le fichier contient une séquence d'images, nous lisons simplement la première, en supprimant le reste.
Variantes
- gdImageCreateFromAvifPtr crée une image à partir des données AVIF déjà en mémoire.
- gdImageCreateFromAvifCtx lit les données des pointeurs de fonction dans une structure gdIOCtx.
Paramètre
| Nom | Description |
|---|---|
| infile | Pointeur vers le fichier d'entrée |
Retour
| Valeur | Description |
|---|---|
| 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. En cas d'erreur, renvoie 0. |
gdImageCreateFromAvifPtr
| gdImagePtr gdImageCreateFromAvifPtr(int size, void *data); |
Voir gdImageCreateFromAvif.
Paramètre
| Nom | Description |
|---|---|
| size | Taille des données Avif en octets. |
| data | Pointeur vers les données Avif. |
gdImageCreateFromAvifCtx
| gdImagePtr gdImageCreateFromAvifCtx(gdIOCtx *ctx); |
Voir gdImageCreateFromAvif.
Détails supplémentaires : la bibliothèque AVIF est dotée de fonctions permettant de créer un objet IO à partir d'un fichier et d'un pointeur de mémoire. Bien entendu, elle ne permet pas de créer un objet IO à partir d'un gdIOCtx. On utilise donc ici notre propre fonction d'assistance, createAvifIOfromCtx.
Sinon, il crée l'image en appelant les fonctions de la bibliothèque AVIF dans l'ordre :
- avifDecoderCreate(), pour créer le décodeur
- avifDecoderSetIO(), pour indiquer à libavif comment lire notre structure de données
- avifDecoderParse(), pour analyser l'image
- avifDecoderNextImage(), pour lire la première image du décodeur
- avifRGBImageSetDefaults(), pour créer l'avifRGBImage
- avifRGBImageAllocatePixels(), pour allouer de la mémoire aux pixels
- avifImageYUVToRGB(), pour convertir YUV en RGB
Enfin, il crée une nouvelle image gd et copions les données de pixels.
Paramètre
| Nom | Description |
|---|---|
| ctx | Ce paramètre permet d'indiquer une structure gdIOCtx. |
gdImageAvifEx
| int gdImageAvifEx(gdImagePtr im, const char *filename, int quality); |
gdImageAvifEx génère l'image spécifiée dans le fichier spécifié au format AVIF. 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. gdImageAvifEx ne ferme pas le fichier ; votre code doit le faire.
Variantes
- gdImageAvifEx écrit l'image dans un fichier, en l'encodant avec la qualité et la vitesse par défaut.
- gdImageAvifPtrEx entrepose l'image dans la RAM.
- gdImageAvifPtr entrepose l'image dans la RAM, en l'encodant avec la qualité et la vitesse par défaut.
- gdImageAvifCtx entrepose l'image à l'aide d'une structure gdIOCtx.
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 d'indiquer la qualité de compression (0 à 100). 0 est la qualité la plus basse, 100 est la qualité la plus élevée. |
| speed | Ce paramètre permet d'indiquer la vitesse de compression (0 à 10). 0 est la plus lente, 10 est la plus rapide. |
Remarques sur les paramètres
| Nom | Description |
|---|---|
| quality | Si quality = -1, nous utilisons une qualité par défaut telle que définie dans QUALITY_DEFAULT. Pour plus d'informations sur la façon dont nous convertissons cette qualité en paramètre de quantité de libavif, voir quality2Quantizer. |
| speed | À des vitesses plus lentes, l'encodage peut être assez lent. Utilisez-le judicieusement. |
Les qualités ou vitesses inférieures à la valeur minimale sont limitées à la valeur minimale, et les qualités ou vitesses inférieures à la valeur maximale sont limitées à la valeur maximale. Notez que AVIF_SPEED_DEFAULT est -1. Si jamais nous définissons SPEED_DEFAULT = AVIF_SPEED_DEFAULT, nous voudrions ajouter une condition pour garantir que la valeur ne soit pas limitée.
Retourne
- pour gdImageAvifEx, gdImageAvif et gdImageAvifCtx, rien.
- pour gdImageAvifPtrEx et gdImageAvifPtr, un pointeur vers l'image en mémoire.