gd.h | Bibliothèque graphique |
|---|---|
| LibGD | |
Description
C'est le fichier principal contenant les déclarations des fonctions et des structures utilisées par la bibliothèque GD. Il inclut les fonctions de manipulation d'images, telles que la création, la modification et l'exportation d'images. Ce fichier est nécessaire pour interagir avec la plupart des fonctionnalités de la bibliothèque, comme la gestion des couleurs, des polices, des transformations d'images et des formats d'exportation (par exemple, PNG, JPEG).
Décomposition des couleurs
| Nom | Description |
|---|---|
| gdTrueColorGetAlpha | Récupère la valeur du canal alpha. |
| gdTrueColorGetRed | Récupère la valeur du canal rouge. |
| gdTrueColorGetGreen | Récupère la valeur du canal vert. |
| gdTrueColorGetBlue | Récupère la valeur du canal bleu. |
Effets
L'effet de superposition
Quantification des couleurs
| Nom | Description |
|---|---|
| gdPaletteQuantizationMethod | Méthode de quantification de la palette. |
Transformation
La méthode d'interpolation pour les transformations.
| Nom | Description |
|---|---|
| gdInterpolationMethod | Définition de la méthode d'interpolation utilisée. |
Format de codage HEIF
Valeurs sélectionnant le format de codage HEIF.
| Nom | Description |
|---|---|
| gdHeifCodec | Valeurs possibles : GD_HEIF_CODEC_UNKNOWN, GD_HEIF_CODEC_HEVC, GD_HEIF_CODEC_AV1. |
Sous-échantillonnage chromatique HEIF
Définit les valeurs de sous-échantillonnage chromatique.
| Nom | Description |
|---|---|
| gdHeifCompression | Valeurs possibles : GD_HEIF_CHROMA_420, GD_HEIF_CHROMA_422, GD_HEIF_CHROMA_444. |
Types
| Nom | Description |
|---|---|
| gdImage | Structure de données utilisée pour stocker des images dans GD. |
| gdImagePtr | Pointeur vers une structure gdImage. |
| gdPointF | Définit un point dans un système de coordonnées 2D à l'aide de valeurs à virgule flottante. |
| gdPointFPtr | Pointeur vers un gdPointF |
| gdFont | Structure de polices contenant les bitmaps des caractères. |
| gdFontPtr | Une structure de police contenant les bitmaps de tous les caractères d'une police de caractères. |
Couleurs
Couleurs spéciales : Les couleurs sont toujours de type int, supposé avoir au moins 32 bits.
Types
| Nom | Description |
|---|---|
| gdSource | Interfaces obsolètes conservées pour compatibilité. |
| gdSourcePtr | Interfaces obsolètes conservées pour compatibilité. |
| gdFTStringExtra | Une structure utilisée pour transmettre des paramètres supplémentaires à la fonction gdImageStringFTEx. |
| gdFTStringExtraPtr | Un pointeur vers une structure gdFTStringExtra, permettant de manipuler facilement ces paramètres dans les appels de fonction. |
| gdPoint | Représente un point dans l'espace de coordonnées de l'image. Utilisé par les fonctions comme gdImagePolygon, gdImageOpenPolygon et gdImageFilledPolygon pour dessiner des polygones. |
| gdPointPtr | Un pointeur vers une structure gdPoint, permettant une manipulation plus flexible des points dans les opérations graphiques. |
| gdRect | Représente un rectangle dans l'espace de coordonnées de l'image. Utilisé pour définir des régions rectangulaires lors de diverses opérations graphiques. |
| gdRectPtr | Un pointeur vers une structure gdRect, utilisé pour référencer facilement des rectangles dans les appels de fonction. |
Composition des couleurs
| Nom | Description |
|---|---|
| gdTrueColorAlpha | Cette fonction compose une valeur couleur au format truecolor en combinant ses composantes individuelles (rouge, vert, bleu et alpha). |
WebP
| Nom | Description |
|---|---|
| gdWebpLossless | Seuil de qualité sans perte. |
GifAnim
Les valeurs légales pour la disposition des cadres dans une animation GIF spécifient comment chaque cadre doit être traité une fois qu'il est affiché.
| Nom | Description |
|---|---|
| gdImageGifAnim | Cette fonction est utilisée pour générer une animation GIF à partir d'une série d'images dans LibGD. Elle peut être utilisée pour ajouter des cadres successifs à une animation existante ou pour en créer une nouvelle. |
Types
| Nom | Description |
|---|---|
| gdSink | Une structure utilisée pour représenter un "sink" (destination) dans LibGD, pouvant recevoir des données (comme des pixels ou des informations d'image) lors des opérations d'écriture ou de manipulation. |
| gdSinkPtr | Un pointeur vers une structure gdSink, permettant une utilisation plus souple dans les appels de fonction. |
Macros d'accès
Les macros d'accès dans LibGD facilitent la récupération de diverses propriétés et informations sur une image ou ses composantes. Voici une description détaillée des macros mentionnées :
| Nom | Description |
|---|---|
| gdImageTrueColor | Vérifie si l'image est au format truecolor (vrai couleur). Une image truecolor utilise des composantes alpha, rouge, vert et bleu pour représenter les couleurs. |
| gdImageSX | Retourne la largeur de l'image en pixels. |
| gdImageSY | Retourne la hauteur de l'image en pixels. |
| gdImageColorsTotal | Obtient le nombre total de couleurs dans la palette de l'image (valable uniquement pour les images au format palette). |
| gdImageRed | Retourne la composante rouge d'une couleur donnée. |
| gdImageGreen | Retourne la composante verte d'une couleur donnée. |
| gdImageBlue | Retourne la composante bleue d'une couleur donnée. |
| gdImageAlpha | Retourne la valeur de la composante alpha (transparence) d'une couleur donnée. |
| gdImageGetTransparent | Récupère la couleur transparente définie pour l'image (valable pour les images utilisant des palettes). |
| gdImageGetInterlaced | Vérifie si une image est entrelacée. L'entrelacement améliore la visualisation progressive des images lors du chargement. |
| gdImagePalettePixel | Récupère la couleur d'un pixel dans une image au format palette. |
| gdImageTrueColorPixel | Récupère la couleur d'un pixel dans une image au format truecolor. |
| gdImageResolutionX | Retourne la résolution horizontale de l'image, exprimée en points par pouce (DPI). |
| gdImageResolutionY | Retourne la résolution verticale de l'image, exprimée en points par pouce (DPI). |
Recadrage
| Nom | Description |
|---|---|
| gdCropMode | Définit les différentes méthodes de recadrage disponibles dans LibGD. Ces modes déterminent la façon dont une image sera recadrée, par exemple en fonction d'un rectangle défini par l'utilisateur, d'une détection automatique des bordures, ou d'autres critères. |
Comparaison d'images
Les fonctionnalités de comparaison d'images dans LibGD permettent d'évaluer la similarité entre deux images. Cela peut être utilisé pour vérifier les modifications apportées à une image, comparer des miniatures ou effectuer des tests de régression graphique.
Décomposition des couleurs
gdTrueColorGetAlpha
Cette fonction permet de demander la valeur du canal alpha.
| int gdTrueColorGetAlpha(int c); |
Paramètre
| Nom | Description |
|---|---|
| c | Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdTrueColorAlpha
gdTrueColorGetRed
Cette fonction permet de demander la valeur du canal rouge.
| int gdTrueColorGetRed(int color); |
Paramètre
| Nom | Description |
|---|---|
| c | Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdTrueColorAlpha
gdTrueColorGetGreen
| int gdTrueColorGetGreen(int c); |
Cette fonction permet de demander la valeur du canal vert.
Paramètre
| Nom | Description |
|---|---|
| c | Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdTrueColorAlpha
gdTrueColorGetBlue
Cette fonction permet de demander la valeur du canal bleu.
Paramètre
| Nom | Description |
|---|---|
| c | Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdTrueColorAlpha
Les effets
L'effet de superposition. Lorsque les pixels sont dessinés, les nouvelles couleurs sont «mélangées» avec l'arrière-plan en fonction de l'effet.
Notez que l'effet ne s'applique pas aux images de palette, où les pixels sont toujours remplacés.
| Mode | Description |
|---|---|
| gdEffectReplace | Remplacer les pixels |
| gdEffectAlphaBlend | Mélange les pixels, voir gdAlphaBlend |
| gdEffectNormal | Mode par défaut; identique à gdEffectAlphaBlend |
| gdEffectOverlay | Superposition de pixels, voir gdLayerOverlay |
| gdEffectMultiply | Superposer des pixels avec effet de multiplication, voir gdLayerMultiply |
Voir également
- gdImageAlphaBlending
Quantification des couleurs
gdPaletteQuantizationMethod
| Constante | Description |
|---|---|
| GD_QUANT_DEFAULT | GD_QUANT_LIQ si libimagequant est disponible, GD_QUANT_JQUANT sinon. |
| GD_QUANT_JQUANT | Ancienne version médiane de libjpeg. Rapide, mais n'utilise que des couleurs 16 bits. |
| GD_QUANT_NEUQUANT | NeuQuant - approximation utilisant le réseau neuronal de Kohonen. |
| GD_QUANT_LIQ | Une combinaison d'algorithmes utilisés dans libimagequant visant la plus haute qualité au détriment de la vitesse. |
Notez que GD_QUANT_JQUANT ne conserve pas le canal alpha et que GD_QUANT_NEUQUANT ne prend pas en charge le tramage.
Voir également
- gdImageTrueColorToPaletteSetMethod
Transformation
gdInterpolationMethod
Voici les différentes méthodes d'interpolation disponibles dans LibGD, utilisées pour redimensionner les images. Voici un aperçu des méthodes d'interpolation et leur description :
| Constante | Description |
|---|---|
| GD_BELL | Interpolation Bell, qui utilise une fonction de type cloche pour l'interpolation. |
| GD_BESSEL | Interpolation de Bessel, qui est utilisée pour des applications d'images scientifiques. |
| GD_BILINEAR_FIXED | Interpolation bilinéaire à points fixes, adaptée à l'utilisation de valeurs entières pour le calcul. |
| GD_BICUBIC | Interpolation bicubique, offrant des résultats de qualité supérieure à la bilinéaire en utilisant un polynôme de degré 3. |
| GD_BICUBIC_FIXED | Interpolation bicubique à points fixes, une version de l'interpolation bicubique utilisant des entiers. |
| GD_BLACKMAN | Interpolation Blackman, qui utilise une fenêtre Blackman pour améliorer la qualité de l'image. |
| GD_BOX | Interpolation en boîte, simplifie l'image en la réduisant à la valeur moyenne d'un pixel. |
| GD_BSPLINE | Interpolation B-spline, basée sur des courbes de B-splines pour un lissage plus fin. |
| GD_CATMULLROM | Interpolation Catmull-Rom, une méthode de spline cubique pour un rendu lisse des images. |
| GD_GAUSSIAN | Interpolation gaussienne, qui applique une courbe gaussienne pour un lissage doux. |
| GD_GENERALIZED_CUBIC | Interpolation cubique généralisée, une version améliorée de l'interpolation bicubique. |
| GD_HERMITE | Interpolation Hermite, utilisée pour préserver les bords tout en lissant l'image. |
| GD_HAMMING | Interpolation Hamming, qui utilise une fenêtre de Hamming pour réduire les oscillations. |
| GD_HANNING | Interpolation Hanning, une autre méthode de fenêtre qui offre un lissage. |
| GD_MITCHELL | Interpolation Mitchell, connue pour son bon compromis entre lissage et préservation des détails. |
| GD_NEAREST_NEIGHBOUR | Interpolation par voisin le plus proche, qui est la méthode la plus simple et rapide. |
| GD_POWER | Interpolation par puissance, qui ajuste les pixels voisins en fonction d'une fonction de puissance. |
| GD_QUADRATIC | Interpolation quadratique, utilisée pour un lissage rapide mais avec des artefacts limités. |
| GD_SINC | Interpolation Sinc, une méthode d'interpolation à l'aide de la fonction Sinc pour des résultats très fins. |
| GD_TRIANGLE | Interpolation triangulaire, qui applique une fonction en forme de triangle. |
| GD_WEIGHTED4 | Interpolation bilinéaire pondérée, une variation de la bilinéaire utilisant 4 pixels voisins. |
| GD_LINEAR | Interpolation bilinéaire standard, qui est souvent utilisée pour une réduction simple de la taille de l'image. |
Voir également
- gdImageSetInterpolationMethod, gdImageGetInterpolationMethod
Format de codage HEIF
Valeurs sélectionnant le format de codage HEIF.
gdHeifCodec
GD_HEIF_CODEC_UNKNOWN GD_HEIF_CODEC_HEVC GD_HEIF_CODEC_AV1
Voir également
- gdImageHeif
Sous-échantillonnage de la chrominance HEIF
Valeurs qui sélectionnent le sous-échantillonnage de la chrominance HEIF.
gdHeifCompression
GD_HEIF_CHROMA_420 GD_HEIF_CHROMA_422 GD_HEIF_CHROMA_444
Voir également
- gdImageHeif
Types
gdImage
Il s'agit de la structure principale contenant les informations relatives à l'image, comme sa largeur, sa hauteur, le type de couleur (par exemple, vrai couleur ou palette), ainsi que les données des pixels de l'image.
gdImagePtr
La structure de données dans laquelle gd entrepose les images. gdImageCreate, gdImageCreateTrueColor et les différentes fonctions de chargement de fichiers image renvoient un pointeur vers ce type, et les autres fonctions s'attendent à recevoir un pointeur vers ce type comme premier paramètre.
gdImagePtr est un pointeur vers gdImage.
Voir également
- Macros d'accès
(Les versions précédentes de cette bibliothèque encourageaient la manipulation directe du contenu de la structure, mais nous essayons de nous éloigner de cette pratique, donc les champs ne sont plus documentés ici. Si vous avez besoin de fouiller dans les entrailles de cette structure, n'hésitez pas à consulter gd.h.)
gdPointF
Définit un point dans un système de coordonnées 2D à l'aide de valeurs à virgule flottante. x - Position à virgule flottante (augmente de gauche à droite) y - Position de ligne à virgule flottante (augmente de haut en bas)
gdPointFPtr
Pointeur vers un gdPointF
Voir également
- gdImageCreate, gdImageCreateTrueColor
gdFont
Il s'agit d'une structure représentant une police de caractères bitmap dans LibGD. Elle contient les informations nécessaires pour dessiner les caractères d'une police de caractères, tels que les données bitmap pour chaque caractère ainsi que la taille de la police de caractères.
gdFontPtr
Une structure de police de caractères contenant les bitmaps de tous les caractères d'une police de caractères. Utilisée pour déclarer les caractéristiques d'une police de caractères. Les fonctions de sortie de texte attendent ces éléments comme deuxième argument, après le paramètre gdImagePtr. gdFontGetSmall et gdFontGetLarge en renvoient tous deux un.
Vous pouvez fournir vos propres données de police de caractères en fournissant une telle structure et le tableau de pixels associé. Vous pouvez déterminer la largeur et la hauteur d'un seul caractère dans une police de caractères en examinant les membres w et h de la structure. Si vous ne créez pas vos propres polices de caractères, vous n'aurez pas à vous soucier du reste des composants de cette structure.
Veuillez consulter les fichiers gdfontl.c et gdfontl.h pour un exemple de déclaration appropriée de cette structure.
- typedef struct {
- /* Nombre de caractères dans la police de caractères */
- int nchars;
- /* Le premier caractère est numéroté... (généralement 32 = espace) */
- int offset;
- /* Largeur et hauteur des caractères */
- int w;
- int h;
- /* Données de police ; tableau de caractères, une ligne après l'autre. Facilement inclus dans le code, */
- /* également facilement chargés à partir de fichiers de données. */
- char *data;
- } gdFont;
gdFontPtr est un pointeur vers gdFont.
Couleurs
Les couleurs sont toujours de type int, étant censé être au moins large de 32 bits.
Types de couleurs
| Type | Description |
|---|---|
| Vraies couleurs | Valeurs ARGB où le canal alpha est stocké comme octet le plus significatif et le canal bleu comme octet le moins significatif. Notez que le canal alpha utilise uniquement les 7 bits les moins significatifs. Ne vous fiez pas à la représentation interne, cependant, et utilisez gdTrueColorAlpha pour composer une valeur de couleur vraie, et gdTrueColorGetAlpha, gdTrueColorGetRed, gdTrueColorGetGreen et gdTrueColorGetBlue pour accéder aux canaux respectifs. |
| Index de palette | L'index d'une entrée de palette de couleurs (0-255). |
| Couleurs spéciales | Comme indiqué dans la section suivante. |
Couleurs spéciales
| Nom | Description |
|---|---|
| gdStyled | Utiliser le style actuel, voir gdImageSetStyle |
| gdBrushed | Utiliser le pinceau actuel, voir gdImageSetBrush |
| gdStyledBrushed | Utiliser le style et le pinceau actuels |
| gdTiled | Utiliser la tuile actuelle, voir gdImageSetTile |
| gdTransparent | Indique la transparence, ce qui n'est pas la même chose que l'index de couleur transparente ; utilisé uniquement pour les lignes. |
| gdAntiAliased | Dessiner avec anti-crénelage |
gdSource
Ce type était utilisé pour représenter une source d'image dans des fonctions qui manipulaient les entrées d'image dans LibGD. Par exemple, cela pourrait inclure des données comme les pixels ou les métadonnées d'une image à charger ou à manipuler. Cependant, en raison de son obsolescence, son utilisation est déconseillée.
gdSourcePtr
Remarque : cette interface est obsolète et n'est conservée que pour des raisons de compatibilité. Utilisez plutôt gdIOCtx.
Représente une source à partir de laquelle un PNG peut être lu. Les programmeurs qui ne souhaitent pas lire les PNG à partir d'un fichier peuvent fournir leur propre mécanisme d'entrée alternatif, en utilisant la fonction gdImageCreateFromPngSource. Consultez la documentation de cette fonction pour un exemple d'utilisation appropriée de ce type.
La fonction source doit renvoyer -1 en cas d'erreur, sinon le nombre d'octets récupérés est égal à 0. 0 correspond à EOF, pas à une erreur !
'context' sera transmis à votre fonction source.
gdFTStringExtra
Il s'agit d'une structure contenant des informations supplémentaires utilisées lors du rendu de texte avec la fonction gdImageStringFTEx. Ces informations peuvent inclure des paramètres comme des déplacements pour l'affichage du texte, des effets spécifiques à appliquer ou d'autres configurations particulières liées à l'affichage du texte sur l'image.
gdFTStringExtraPtr
Une structure et un type de pointeur associé utilisés pour transmettre des paramètres supplémentaires à la fonction gdImageStringFTEx. Voir gdImageStringFTEx pour la définition de la structure.
gdPoint
Il s'agit d'une structure représentant un point dans l'espace de coordonnées de l'image.
gdPointPtr
Représente un point dans l'espace de coordonnées de l'image ; utilisé par gdImagePolygon, gdImageOpenPolygon et gdImageFilledPolygon pour le dessin de polygones.
gdRect
Un rectangle dans l'espace de coordonnées de l'image.
| Membres | Description |
|---|---|
| x | La coordonnée x du coin supérieur gauche. |
| y | La coordonnée y du coin supérieur gauche. |
| width | La largeur. |
| height | La hauteur. |
gdRectPtr
Un pointeur vers un gdRect
Composition des couleurs
gdTrueColorAlpha
| int gdTrueColorAlpha(int r, int g, int b, int a); |
Cette fonction permet de composer une valeur de vraie couleur à partir de ses composantes.
Paramètre
| Nom | Description |
|---|---|
| r | Le canal rouge (0 à 255) |
| g | Le canal vert (0 à 255) |
| b | Le canal bleu (0 à 255) |
| a | Le canal alpha (0-127, où 127 est entièrement transparent et 0 est entièrement opaque). |
Voir également
- gdTrueColorGetAlpha, gdTrueColorGetRed, gdTrueColorGetGreen, gdTrueColorGetBlue, gdImageColorExactAlpha
WebP
gdWebpLossless
Seuil de qualité sans perte. Lorsque la qualité de l'image est supérieure ou égale à gdWebpLossless, l'image sera écrite au format WebP sans perte.
Voir également
- gdImageWebpEx
GifAnim
Valeurs légales pour l'élimination. gdDisposalNone est toujours utilisé par l'optimiseur intégré si previm est passé.
| gdImageGifAnim | Description |
|---|---|
| gdDisposalUnknown | Non recommandé |
| gdDisposalNone | Conserver le cadre précédent. |
| gdDisposalRestoreBackground | Première couleur attribuée de la palette. |
| gdDisposalRestorePrevious | Restaurer avant le début de l'image. |
Voir également
- gdImageGifAnimAdd
gdSink
Il représente un objet de gestion des sorties d'images. Il est utilisé pour entreposer des informations sur les destinations de sortie pour la création d'images dans un format donné.
gdSinkPtr
Remarque : cette interface est obsolète et n'est conservée que pour des raisons de compatibilité. Utilisez plutôt gdIOCtx.
Représente un «puits» (destination) vers lequel un PNG peut être écrit. Les programmeurs ne souhaitant pas écrire de PNG dans un fichier peuvent fournir leur propre mécanisme de sortie alternatif, en utilisant la fonction gdImagePngToSink. Consultez la documentation de cette fonction pour un exemple d'utilisation appropriée de ce type.
La fonction sink doit renvoyer -1 en cas d'erreur, sinon le nombre d'octets écrits doit être égal à len.
Le contexte sera transmis à votre fonction sink.
Macros d'accès
gdImageTrueColor
Si une image est une image en vraies couleurs.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image |
Retour
| Valeur | Description |
|---|---|
| Entier | Différent de zéro si l'image est une image en vraies couleurs, zéro pour les images en palette. |
gdImageSX
Obtient la largeur (en pixels) d'une image.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
gdImageSY
Obtient la hauteur (en pixels) d'une image.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
gdImageColorsTotal
Obtient le nombre de couleurs dans la palette.
Cette macro n'est valable que pour les images de palette.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
gdImageRed
Obtient la valeur de la composante rouge d'une couleur donnée.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| c | Ce paramètre permet d'indiquer la couleur. |
gdImageGreen
Obtient la valeur de la composante vert d'une couleur donnée.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| c | Ce paramètre permet d'indiquer la couleur. |
gdImageBlue
Obtient la valeur de la composante bleu d'une couleur donnée.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| c | Ce paramètre permet d'indiquer la couleur. |
gdImageAlpha
Obtient la valeur de la composante alpha d'une couleur donnée.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| c | Ce paramètre permet d'indiquer la couleur. |
gdImageGetTransparent
Obtient la couleur transparente de l'image.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
Voir également
- gdImageColorTransparent, gdImageGetInterlaced
Si une image est entrelacée.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
Retour
| Valeur | Description |
|---|---|
| Entier | Non nul pour les images entrelacées, zéro sinon. |
Voir également
- gdImageInterlace, gdImagePalettePixel
Obtient la couleur d'un pixel.
L'appel de cette macro n'est valable que pour les images de palette. Aucune vérification des limites n'est effectuée pour les coordonnées.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| x | La coordonnée x. |
| y | La coordonnée y. |
Voir également
- gdImageTrueColorPixel, gdImageGetPixel
gdImageTrueColorPixel
Obtient la couleur d'un pixel.
L'appel de cette macro n'est valable que pour les images en vraies couleurs. Aucune vérification des limites n'est effectuée pour les coordonnées.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
| x | La coordonnée x. |
| y | La coordonnée y. |
Voir également
- gdImagePalettePixel, gdImageGetTrueColorPixel
gdImageResolutionX
Obtient la résolution horizontale en DPI.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
Voir également
- gdImageResolutionY, gdImageSetResolution
gdImageResolutionY
Obtient la résolution verticale en DPI.
Paramètre
| Nom | Description |
|---|---|
| im | Ce paramètre permet d'indiquer l'image. |
Voir également
- gdImageResolutionX, gdImageSetResolution
Recadrer
Les constantes gdCropMode dans LibGD
Les constantes suivantes sont utilisées avec la fonction gdImageCrop() ou des fonctions similaires pour spécifier la méthode de recadrage d'une image. Chaque constante définit un mode particulier pour couper l'image selon des critères spécifiques.
| Constante | Description |
|---|---|
| GD_CROP_DEFAULT | Cette constante agit de la même manière que GD_CROP_TRANSPARENT. Elle permet de recadrer l'image en utilisant la couleur transparente comme critère de découpe. Cela est utile pour enlever des zones transparentes autour de l'image. |
| GD_CROP_TRANSPARENT | Ce mode de recadrage permet de couper les zones transparentes de l'image. Cela est particulièrement utile pour les images avec un fond transparent où l'on souhaite supprimer les bords transparents pour ne conserver que l'image principale. |
| GD_CROP_BLACK | Ce mode permet de recadrer les bordures noires de l'image. Lorsque l'image a des bords noirs ou foncés non désirés, cette option permet de les supprimer automatiquement, ne conservant que la partie centrale de l'image. |
| GD_CROP_WHITE | Ce mode permet de recadrer les bordures blanches de l'image. Il est utile pour éliminer les zones blanches autour de l'image, souvent présentes dans les images avec un fond blanc ou clair. |
| GD_CROP_SIDES | Cette constante utilise les couleurs des quatre coins de l'image pour déterminer la zone à recadrer. Les couleurs des coins sont analysées pour décider où couper, ce qui est utile pour des images avec des bords colorés uniformément. |
Voir également
- gdImageCropAuto
Constants de comparaison d'image dans LibGD
Les constantes suivantes sont utilisées pour déterminer les différences entre deux images lorsqu'on utilise les fonctions de comparaison dans LibGD. Elles permettent de spécifier quel aspect de l'image a changé lors de la comparaison.
| Constante | Description |
|---|---|
| GD_CMP_IMAGE | Cette constante est retournée lorsque l'image réelle (contenu des pixels) est différente entre les deux images comparées. Cela signifie que les pixels de l'image ont été modifiés. |
| GD_CMP_NUM_COLORS | Cette constante indique que le nombre de couleurs dans la palette de l'image diffère entre les deux images. Cela concerne les images indexées où les palettes de couleurs sont utilisées. |
| GD_CMP_COLOR | Cette constante indique que les couleurs utilisées dans l'image ont changé. Elle se réfère aux différences de teinte, de saturation ou de luminosité dans les couleurs. |
| GD_CMP_SIZE_X | Cette constante est utilisée lorsque la largeur de l'image diffère entre les deux images comparées. Cela est utile pour vérifier si les dimensions horizontales des images ont été modifiées. |
| GD_CMP_SIZE_Y | Cette constante est utilisée lorsque la hauteur de l'image diffère entre les deux images comparées. Cela permet de détecter les changements dans les dimensions verticales. |
| GD_CMP_TRANSPARENT | Cette constante est retournée lorsque la couleur transparente de l'image a changé. Cela concerne les images qui utilisent un canal alpha ou une couleur transparente spécifique. |
| GD_CMP_BACKGROUND | Cette constante indique que la couleur de fond de l'image a changé. Cela concerne les images dont l'arrière-plan est défini par une couleur spécifique. |
| GD_CMP_INTERLACE | Cette constante est utilisée pour indiquer que l'option d'entrelacement (interlace) de l'image est différente entre les deux images comparées. Les images entrelacées sont souvent utilisées pour permettre une visualisation progressive sur les pages web. |
| GD_CMP_TRUECOLOR | Cette constante est retournée lorsque les images diffèrent en termes de mode de couleur (truecolor vs palette). Cela permet de détecter si une image est en mode truecolor (24 bits) et l'autre en mode palette (indexée). |
Voir également
- gdImageCompare