Les entrées/sorties WBMP
Le format WBMP (Wireless Bitmap) est principalement utilisé pour les appareils mobiles et les technologies sans fil, notamment dans les systèmes de messagerie et les applications Web sur des terminaux aux capacités graphiques limitées. Dans le cadre de la bibliothèque LibGD, "WBMP IO" désigne les fonctions permettant de lire et d'écrire des images au format WBMP, un format prenant en charge les images en niveaux de gris avec une compression simple. Ce format est souvent utilisé dans des contextes où les ressources de traitement et d'entreposage sont limitées, comme dans les premiers téléphones mobiles ou autres appareils portables.
LibGD inclut plusieurs fonctions pour manipuler les images WBMP, à commencer par celles permettant de créer des images à partir de fichiers WBMP existants. La fonction gdImageCreateFromWBMP permet de charger une image WBMP dans un objet gdImagePtr. Cette fonction est essentielle pour convertir des fichiers WBMP en objets internes que la bibliothèque LibGD peut manipuler. Une fois l'image chargée, elle peut être traitée, modifiée, ou convertie dans un autre format, selon les besoins de l'application.
Une autre fonction clef dans le domaine de l'IO WBMP de LibGD est gdImageWBMP, permettant d'écrire une image dans un fichier WBMP à partir d'un objet gdImagePtr. Cette fonction est utilisée lorsque l'on souhaite sauvegarder une image modifiée ou générée sous ce format spécifique. Elle est simple à utiliser, et prend en charge l'écriture des images en niveaux de gris dans un fichier WBMP. Comme pour d'autres formats pris en charge par LibGD, il est également possible de personnaliser certains aspects du processus de création du fichier WBMP, comme le niveau de compression.
Les fonctions de lecture et d'écriture des images WBMP avec LibGD sont particulièrement adaptées aux applications où les images doivent être utilisées dans des environnements à faible bande passante ou dans des appareils ayant des capacités graphiques limitées. De plus, ces fonctions sont très utiles pour les applications mobiles ou anciennes, où le format WBMP était largement utilisé. Bien que le format WBMP soit de moins en moins courant aujourd'hui, il reste essentiel dans certains domaines spécifiques, et LibGD permet de continuer à l'utiliser efficacement.
Les fonctions
Paramètre
| Nom | Description |
|---|---|
| gdImageWBMPCtx | Cette fonction est utilisée pour écrire une image au format WBMP dans un fichier. Elle prend en paramètre un objet gdImagePtr (représentant l'image à enregistrer) et écrit le contenu dans un fichier en utilisant un flux de données gdIOCtx. Cela permet d'utiliser des mécanismes d'entrée/sortie personnalisés, comme les tampons en mémoire, pour manipuler l'image. |
| gdImageCreateFromWBMPCtx | Cette fonction est utilisée pour lire une image WBMP à partir d'un flux de données en utilisant une structure gdIOCtx. Elle crée un objet gdImagePtr qui contient les données de l'image, permettant ainsi de manipuler l'image après son chargement sans dépendre directement de fichiers, mais plutôt d'un flux de données personnalisé. |
| gdImageCreateFromWBMP | Elle est utilisée pour charger une image au format WBMP depuis un fichier. La fonction crée un objet gdImagePtr à partir du fichier spécifié et permet ensuite d'effectuer diverses manipulations ou transformations sur l'image. Cette fonction est typiquement utilisée pour lire des images WBMP à partir de fichiers entreposés sur disque. |
| gdImageCreateFromWBMPPtr | Cette fonction est similaire à gdImageCreateFromWBMP, mais elle retourne un pointeur vers l'image WBMP lue en mémoire, plutôt que d'effectuer des opérations directement sur des fichiers. Cela permet de charger et manipuler une image sans nécessiter un fichier physique. |
| gdImageWBMP | Cette fonction écrit une image dans un fichier WBMP à partir d'un objet gdImagePtr. Elle permet de sauvegarder une image en mémoire dans un fichier au format WBMP, sans avoir besoin de manipuler un flux d'entrée/sortie personnalisé. |
| gdImageWBMPPtr | Elle est similaire à gdImageWBMP, mais retourne un pointeur vers les données WBMP en mémoire, plutôt que d'écrire directement dans un fichier. Cela permet de récupérer les données de l'image sous forme binaire sans avoir besoin de gérer de fichiers. |
gdImageWBMPCtx
| void gdImageWBMPCtx(gdImagePtr image, int fg, gdIOCtx *out); |
Écrire l'image sous forme de fichier wbmp.
Paramètre
| Nom | Description |
|---|---|
| image | Ce paramètre permet d'indiquer la structure de l'image GD. |
| fg | Ce paramètre permet d'indiquer l'index de la couleur de premier plan. toute autre valeur sera considérée comme arrière-plan et ne sera pas écrite. |
| out | Ce paramètre permet d'indiquer le flux de données où écrire |
gdImageCreateFromWBMPCtx
| gdImagePtr gdImageCreateFromWBMPCtx( gdIOCtx * infile); |
Lit une image WBMP via une structure gdIOCtx. Voir gdImageCreateFromWBMP.
gdImageCreateFromWBMP
| gdImagePtr gdImageCreateFromWBMP(FILE * inFile); |
gdImageCreateFromWBMP est appelé pour charger des images à partir de fichiers au format WBMP. Appelez gdImageCreateFromWBMP avec un pointeur déjà ouvert vers un fichier contenant l'image souhaitée. gdImageCreateFromWBMP renvoie un gdImagePtr vers la nouvelle image, 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 WBMP). gdImageCreateFromWBMP 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.
Variantes
gdImageCreateFromWBMPPtr crée une image à partir de données WBMP (c'est-à-dire le contenu d'un fichier WBMP) déjà en mémoire.
gdImageCreateFromWBMPCtx lit une image à l'aide des fonctions d'une structure gdIOCtx.
Paramètre
| Nom | Description |
|---|---|
| infile | Ce paramètre permet d'indiquer le pointeur de fichier d'entrée. |
Retour
| Valeur | Description |
|---|---|
| Pointeur | Un pointeur vers la nouvelle image ou NULL si une erreur s'est produite. |
Exemple
gdImageCreateFromWBMPPtr
| gdImagePtr gdImageCreateFromWBMPPtr(int size, void *data); |
Paramètre
| Nom | Description |
|---|---|
| size | Ce paramètre permet d'indiquer la taille des données WBMP en octets. |
| data | Ce paramètre permet d'indiquer les données WBMP (c'est-à-dire le contenu d'un fichier WBMP). |
Voir gdImageCreateFromWBMP.
gdImageWBMP
| void gdImageWBMP(gdImagePtr im, int fg, FILE * outFile); |
Cette fonction écrit une image dans un fichier WBMP à partir d'un objet gdImagePtr. Elle permet de sauvegarder une image en mémoire dans un fichier au format WBMP, sans avoir besoin de manipuler un flux d'entrée/sortie personnalisé.
gdImageWBMPPtr
| void * gdImageWBMPPtr(gdImagePtr im, int *size, int fg); |
Elle est similaire à gdImageWBMP, mais retourne un pointeur vers les données WBMP en mémoire, plutôt que d'écrire directement dans un fichier. Cela permet de récupérer les données de l'image sous forme binaire sans avoir besoin de gérer de fichiers.