gdImageFile |
Ficher d'image |
| LibGD |
Syntaxe
|
int gdImageFile(gdImagePtr im, const char *filename);
|
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. |
Description
Cette fonction permet d'écrire une image dans un fichier.
Remarques
- É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.
Dernière mise à jour : Mercredi, le 29 Janvier 2025
