gd_filename.c | Bibliothèque graphique |
|---|---|
| LibGD | |
Description
Ce fichier permet la gestion des fichiers et des noms de fichiers utilisés avec LibGD.
Les fonctions
| Nom | Description |
|---|---|
| gdSupportsFileType | Vérifie si un type de fichier donné est pris en charge par GD. |
| gdImageCreateFromFile | Lit un fichier image de n'importe quel format pris en charge. |
| gdImageFile | Écrit une image dans un fichier au format indiqué par le nom de fichier. |
gdSupportsFileType
| int gdSupportsFileType(const char *filename, int writing); |
Teste si un type de fichier donné est pris en charge par GD.
Étant donné le nom d'un fichier image (qui n'a pas besoin d'exister), renvoie 1 (c'est-à-dire TRUE) si gdImageCreateFromFile peut lire un fichier de ce type. Ceci est utile si vous ne savez pas quels types d'images ont été activés au moment de la compilation.
Si l'écriture est vraie, le résultat sera vrai uniquement si gdImageFile peut écrire un fichier de ce type.
Notez que l'analyse des noms de fichiers est effectuée exactement de la même manière que celle effectuée par gdImageCreateFromFile et gdImageFile et est soumise aux mêmes limitations.
En supposant que LibGD soit compilé avec la prise en charge de ces types d'images, les extensions suivantes sont prises en charge :
- .gif
- .gd, .gd2
- .wbmp
- .bmp
- .xbm
- .tga
- .png
- .jpg, .jpeg
- .heif, .heix
- .avif
- .tiff, .tif
- .webp
- .xpm
Les noms sont analysés sans tenir compte de la casse.
Paramètre
| Nom | Description |
|---|---|
| filename | Ce paramètre permet d'indiquer le nom de fichier avec extension testée. |
| writing | Ce paramètre permet d'indiquer un drapeau : vrai teste si l'écriture fonctionne |
Retour
| Valeur | Description |
|---|---|
| Entier | GD_TRUE (1) si le type de fichier est pris en charge, GD_FALSE (0) sinon. |
gdImageCreateFromFile
| gdImagePtr gdImageCreateFromFile(const char *filename) |
Lire un fichier image pris en charge.
Étant donné le chemin d'accès à un fichier, gdImageCreateFromFile ouvrira le fichier, lira son contenu avec la fonction gdImageCreateFrom* appropriée et le renverra.
Le type de fichier est déterminé par l'extension du nom de fichier, donc une extension incorrecte ne fonctionnera probablement pas. Par exemple, renommer une image PNG «foo.png» en «foo.gif» puis tenter de la charger échouera même si GD prend en charge les deux formats. Voir gdSupportsFiletype pour plus de détails.
NULL est renvoyé en cas d'erreur.
Paramètre
| Nom | Description |
|---|---|
| filename | Ce paramètre permet d'indiquer le nom du fichier d'entrée. |
Retour
| Valeur | Description |
|---|---|
| Pointeur | Un pointeur vers la nouvelle image ou NULL si une erreur s'est produite. |
gdImageFile
| int gdImageFile(gdImagePtr im, const char *filename); |
Écrit une image dans un fichier au format indiqué par le nom de fichier.
Le type de fichier est déterminé par l'extension du nom de fichier. Voir gdSupportsFiletype pour un aperçu de l'analyse.
Pour les types de fichiers nécessitant des paramètres supplémentaires, gdImageFile tente d'utiliser des valeurs par défaut raisonnables :
- gdImageGd2 taille du bloc = 0, la compression est activée.
- gdImageJpeg qualité = -1 (c'est-à-dire la valeur par défaut raisonnable)
- gdImageWBMP le premier plan est la couleur la plus sombre disponible
Tout le reste est appelé avec la fonction à deux arguments et utilisera donc les valeurs par défaut.
gdImageFile dispose d'une détection d'erreur rudimentaire et renverra GD_FALSE (0) si une erreur détectable s'est produite. Cependant, les chargeurs d'images ne renvoient normalement pas leur état d'erreur, donc un résultat de GD_TRUE (1) ne signifie **pas** que le fichier a été enregistré avec succès.
Paramètre
| Nom | Description |
|---|---|
| im | L'image à sauvegarder. |
| filename | Le chemin d'accès au fichier dans lequel l'image est enregistrée. |
Retour
| Valeur | Description |
|---|---|
| Pointeur | GD_FALSE (0) si une erreur a été détectée, GD_TRUE (1) sinon. |