Les entrées/sorties XBM
Le XBM IO dans LibGD représente un ensemble de fonctions permettant de gérer les images au format XBM (X Bitmap), un format simple utilisé principalement pour les icônes monochromes dans les interfaces graphiques sous UNIX. Ce format encode les images sous forme de données C, ce qui les rend faciles à intégrer dans des applications écrites en C ou en C++. Grâce à LibGD, il est possible de créer des images XBM, de les manipuler et de les exporter ou d'importer des fichiers XBM existants pour les convertir en d'autres formats pris en charge. Cela permet aux développeurs de conserver ou d'interagir avec ce format historique tout en profitant des fonctionnalités modernes de LibGD.
LibGD fournit des fonctions spécifiques pour charger des fichiers XBM existants. Par exemple, la fonction gdImageCreateFromXbm permet de lire un fichier XBM et de créer une instance d'image GD à partir de celui-ci. Une fois chargée, cette image peut être manipulée, modifiée ou convertie en d'autres formats pris en charge, tels que PNG, JPEG ou WebP. Cette flexibilité est particulièrement utile dans les scénarios où les projets doivent intégrer des actifs graphiques au format XBM dans des environnements modernes.
En plus de la lecture, LibGD permet également de générer des images au format XBM. Avec des fonctions comme gdImageXbm, les développeurs peuvent exporter une image GD vers un fichier XBM. Cela est particulièrement pratique lorsque des icônes ou graphiques simples doivent être exportés dans un format lisible par les anciens systèmes ou logiciels, ou simplement pour respecter des spécifications de projet. LibGD s'assure que l'image exportée respecte les contraintes du format XBM, comme le fait d'être monochrome.
Bien que le format XBM soit aujourd'hui moins courant en raison de l'avènement des formats plus complexes comme PNG et JPEG, il reste un format clef dans des contextes spécifiques, notamment dans les interfaces graphiques héritées ou les projets nécessitant des fichiers très légers. LibGD simplifie l'interaction avec ce format en fournissant une interface intuitive pour la création, la manipulation et la conversion des fichiers XBM. Ainsi, il permet de maintenir une compatibilité avec les anciens formats tout en intégrant des outils modernes pour répondre aux besoins actuels.
Les fonctions
| Nom | Description |
|---|---|
| gdImageCreateFromXbm | Cette fonction est utilisée pour charger des images à partir de fichiers au format X bitmap. |
| gdImageXbmCtx | Cette fonction écrit une image dans un contexte d'entrée/sortie au format bitmap X11. |
gdImageCreateFromXbm
| gdImagePtr gdImageCreateFromXbm(FILE *fd); |
gdImageCreateFromXbm est appelé pour charger des images à partir de fichiers au format bitmap X. Appelez gdImageCreateFromXbm avec un pointeur déjà ouvert vers un fichier contenant l'image souhaitée. gdImageCreateFromXbm 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 au format bitmap X). gdImageCreateFromXbm 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.
Les bitmaps X11 (qui définissent un char[]) ainsi que les bitmaps X10 (définissant un short[]) sont pris en charge.
Paramètre
| Nom | Description |
|---|---|
| fd | 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
gdImageXbmCtx
| void gdImageXbmCtx(gdImagePtr image, char * file_name, int fg, gdIOCtx *out); |
Écrit une image dans un contexte IO au format bitmap X11.
Paramètre
| Nom | Description |
|---|---|
| image | Ce paramètre permet d'indiquer le gdImagePtr à écrire. |
| file_name | Ce paramètre permet d'indiquer le préfixe des identifiants du XBM. Les caractères illégaux sont automatiquement supprimés. |
| gd | Ce paramètre permet d'indiquer quelle couleur utiliser comme couleur de premier plan. Tous les pixels d'une autre couleur ne sont pas définis. |
| out | Ce paramètre permet d'indiquer le gdIOCtx pour écrire le fichier image. |