gd.c
| Bibliothèque graphique |
| LibGD |
Description
Ce fichier contient la base de la bibliothèque LibGD, contenant des fonctions fondamentales pour la création, la manipulation et la gestion des images.
Gestion des erreurs
| Nom |
Description |
| gdSetErrorMethod |
Cette fonction permet de définir une méthode ou une fonction personnalisée pour traiter les erreurs dans LibGD. |
| gdClearErrorMethod |
Cette fonction réinitialise le gestionnaire d'erreurs à son état par défaut. |
Création et destruction
| Nom |
Description |
| gdImageCreate |
gdImageCreate est appelé pour créer des images basées sur une palette, avec pas plus de 256 couleurs. |
| gdImageCreateTrueColor |
gdImageCreateTrueColor est appelé pour créer des images en vraies couleurs, avec un nombre essentiellement illimité de couleurs. |
| gdImageDestroy |
gdImageDestroy est utilisé pour libérer la mémoire associée à une image. |
Couleur
| Nom |
Description |
| gdImageColorClosest |
Renvoie l'index de la couleur la plus proche correspondant aux valeurs RVB spécifiées dans l'image. |
| gdImageColorClosestAlpha |
Identique à gdImageColorClosest, mais prend également en compte la composante alpha (transparence). |
| gdImageColorClosestHWB |
Trouve la couleur la plus proche basée sur l'algorithme Hue, Whiteness, Blackness (HWB). |
| gdImageColorExact |
Renvoie l'index de la couleur exacte correspondant aux valeurs RVB spécifiées, ou -1 si aucune correspondance n'est trouvée. |
| gdImageColorExactAlpha |
Identique à gdImageColorExact, mais inclut la composante alpha. |
| gdImageColorAllocate |
Alloue une nouvelle couleur RVB dans la palette de l'image et retourne son index, ou -1 si la palette est pleine. |
| gdImageColorAllocateAlpha |
Alloue une nouvelle couleur avec composantes RVBA (incluant la transparence). |
| gdImageColorResolve |
Cherche une couleur dans la palette ; si non trouvée, en alloue une nouvelle. |
| gdImageColorResolveAlpha |
Identique à gdImageColorResolve, mais prend en compte la composante alpha. |
| gdImageColorDeallocate |
Supprime une couleur de la palette de l'image. |
| gdImageColorTransparent |
Définit une couleur spécifique comme transparente pour l'image. |
| gdImagePaletteCopy |
Copie la palette d'une image vers une autre. |
| gdImageColorReplace |
Remplace toutes les occurrences d'une couleur spécifique par une autre dans l'image. |
| gdImageColorReplaceThreshold |
Remplace une couleur par une autre si la différence entre elles respecte un seuil donné. |
| gdImageColorReplaceArray |
Remplace plusieurs couleurs à la fois en utilisant un tableau de correspondances (ancien → nouveau). |
| gdImageColorReplaceCallback |
Remplace les couleurs selon une fonction callback personnalisée. |
Pixels
| Nom |
Description |
| gdImageSetPixel |
Cette fonction définit (ou dessine) un pixel dans une image à une position donnée. Vous spécifiez les coordonnées (x, y) du pixel et la couleur (indexée ou en mode truecolor) que vous souhaitez appliquer. |
| gdImageGetPixel |
Cette fonction permet d'obtenir la couleur d'un pixel situé à une position donnée dans l'image, sous forme de valeur indexée (dans les images palette) ou de valeur brute (en mode truecolor). |
| gdImageGetTrueColorPixel |
Cette fonction est similaire à gdImageGetPixel, mais elle garantit que la couleur renvoyée est toujours sous forme d'une valeur truecolor, même si l'image est en mode palette. |
Primitives
| Nom |
Description |
| gdImageAABlend |
NO-OP, conservée pour la compatibilité avec la bibliothèque. |
| gdImageLine |
Implémente l'algorithme de Bresenham tel que présenté dans Foley & Van Dam. |
| gdImageDashedLine |
Trace une ligne pointillée. |
| gdImageBoundsSafe |
Assure la sécurité des limites d'une image lors des opérations. |
| gdImageChar |
Dessine un seul caractère. |
| gdImageCharUp |
Dessine un seul caractère, orienté vers le haut. |
| gdImageString |
Dessine une chaîne de caractères. |
| gdImageStringUp |
Dessine une chaîne de caractères, orientée vers le haut. |
| gdImageString16 |
Dessine une chaîne de caractères en utilisant une police de 16 bits. |
| gdImageStringUp16 |
Dessine une chaîne de caractères en utilisant une police de 16 bits, orientée vers le haut. |
| gdImageArc |
Trace un arc. |
| gdImageFilledArc |
Trace un arc rempli. |
| gdImageEllipse |
Trace une ellipse. |
| gdImageFilledEllipse |
Trace une ellipse remplie. |
| gdImageFillToBorder |
Remplie une zone jusqu'à la bordure d'une couleur spécifiée. |
| gdImageFill |
Remplie une zone d'une couleur. |
| gdImageRectangle |
Trace un rectangle. |
| gdImageFilledRectangle |
Trace un rectangle rempli. |
Clonage et copie
| Nom |
Description |
| gdImageClone |
Clone une image |
| gdImageCopy |
Copier une zone d'une image vers une autre image |
| gdImageCopyMerge |
Copier une zone d'une image vers une autre image en ignorant l'alpha |
| gdImageCopyMergeGray |
Copier une zone d'une image vers une autre image en ignorant l'alpha |
| gdImageCopyResized |
Copier une zone redimensionnée d'une image vers une autre image |
| gdImageCopyRotated |
Copier une zone pivotée d'une image vers une autre image |
| gdImageCopyResampled |
Copier une zone rééchantillonnée d'une image vers une autre image |
Polygones
| Nom |
Description |
| gdImagePolygon |
Dessine un polygone fermé |
| gdImageOpenPolygon |
Dessine un polygone ouvert |
| gdImageFilledPolygon |
Dessine un polygone rempli |
Autre
| Nom |
Description |
| gdImageSetStyle |
Définit le style pour les opérations de dessin suivantes. |
| gdImageSetThickness |
Définit l'épaisseur des lignes pour les opérations de dessin suivantes. |
| gdImageSetBrush |
Définit le pinceau pour les opérations de dessin suivantes. |
| gdImageSetTile |
Définit une image comme motif de remplissage pour les opérations de dessin. |
| gdImageSetAntiAliased |
Définit la couleur pour le dessin anti-aliasé suivant. |
| gdImageSetAntiAliasedDontBlend |
Définit la couleur et la couleur "dont_blend" pour le dessin anti-aliasé suivant. |
| gdImageInterlace |
Active ou désactive l'entrelacement de l'image. |
| gdImageCompare |
Compare deux images pour détecter des différences. |
| gdAlphaBlend |
Fusionne deux couleurs en tenant compte de la transparence (alpha). |
| gdLayerOverlay |
Superpose deux couleurs en appliquant une opération de superposition. |
| gdLayerMultiply |
Superpose deux couleurs en appliquant un effet de multiplication. |
| gdImageAlphaBlending |
Définit l'effet de fusion pour les opérations de dessin suivantes. |
| gdImageSaveAlpha |
Active ou désactive la conservation des informations de transparence (alpha). |
| gdImageSetClip |
Définit le rectangle de découpage (clipping) pour les opérations de dessin. |
| gdImageGetClip |
Récupère les coordonnées actuelles du rectangle de découpage. |
| gdImageSetResolution |
Définit la résolution d'une image (en DPI). |
| gdImagePaletteToTrueColor |
Convertit une image en palette de couleurs en une image en couleurs vraies. |
Gestion des erreurs
gdSetErrorMethod
|
void gdSetErrorMethod(gdErrorMethoderror_method);
|
gdClearErrorMethod
|
void gdClearErrorMethod(void);
|
Création et destruction
gdImageCreate
|
gdImagePtr gdImageCreate(int sx, int sy);
|
gdImageCreate est appelé pour créer des images basées sur une palette, avec un maximum de 256 couleurs. L'image doit éventuellement être
détruite à l'aide de gdImageDestroy().
Paramètre
| Nom |
Description |
| sx |
Ce paramètre permet d'indiquer la largeur de l'image. |
| sy |
Ce paramètre permet d'indiquer la hauteur de l'image. |
Retour
| Valeur |
Description |
| Pointeur |
Un pointeur vers la nouvelle image ou NULL si une erreur s'est produite. |
Exemple
- gdImagePtr im;
- im = gdImageCreate(64, 64);
- /* ... Utiliser l'image ... */
- gdImageDestroy(im);
Voir également
gdImageCreateTrueColor
|
gdImagePtr gdImageCreateTrueColor(int sx, int sy);
|
gdImageCreateTrueColor est appelé pour créer des images en vraies couleurs, avec un nombre pratiquement illimité de couleurs. Appelez
gdImageCreateTrueColor avec les dimensions x et y de l'image souhaitée. gdImageCreateTrueColor renvoie un gdImagePtr à la nouvelle image, ou NULL s'il est impossible
d'allouer l'image. L'image doit éventuellement être détruite à l'aide de gdImageDestroy().
Les images en vraies couleurs sont toujours remplies de noir au moment de la création. Il n'existe pas de concept d'index de couleur «d'arrière-plan».
Paramètre
| Nom |
Description |
| sx |
Ce paramètre permet d'indiquer la largeur de l'image. |
| sy |
Ce paramètre permet d'indiquer la hauteur de l'image. |
Retour
| Valeur |
Description |
| Pointeur |
Un pointeur vers la nouvelle image ou NULL si une erreur s'est produite. |
Exemple
- gdImagePtr im;
- im = gdImageCreateTrueColor(64, 64);
- /* ... Utiliser l'image ... */
- gdImageDestroy(im);
Voir également
gdImageDestroy
|
void gdImageDestroy(gdImagePtr im);
|
gdImageDestroy est utilisé pour libérer la mémoire associée à une image. Il est important d'appeler gdImageDestroy avant de quitter
votre programme ou d'assigner une nouvelle image à une variable gdImagePtr.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer un pointeur vers le gdImage à supprimer. |
Retour
Rien
Exemple
- gdImagePtr im;
- im = gdImageCreate(10, 10);
- /* ... Utiliser l'image ... */
- /* Maintenant détruis-le */
- gdImageDestroy(im);
Couleur
gdImageColorClosest
|
int gdImageColorClosest(gdImagePtr im, int r, int g, int b);
|
Obtient la couleur la plus proche de l'image.
Il s'agit d'une variante simplifiée de gdImageColorClosestAlpha où le canal alpha est toujours opaque.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
Retour
| Valeur |
Description |
| Entier |
La couleur la plus proche déjà disponible dans la palette pour les images de palette ; la valeur de couleur des composants donnés pour les images en vraies couleurs. |
Voir également
gdImageColorClosestAlpha
|
int gdImageColorClosestAlpha(gdImagePtr im, int r, int g, int b, int a);
|
Obtient la couleur la plus proche de l'image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
| a |
Ce paramètre permet d'indiquer la valeur de la composante alpha. |
Retour
| Valeur |
Description |
| Entier |
La couleur la plus proche déjà disponible dans la palette pour les images de palette ; la valeur de couleur des composants donnés pour les images en vraies couleurs. |
Voir également
gdImageColorClosestHWB
|
int gdImageColorClosestHWB(gdImagePtr im, int r, int g, int b);
|
gdImageColorExact
|
int gdImageColorExact(gdImagePtr im, int r, int g, int b);
|
Obtient la couleur exacte de l'image.
Il s'agit d'une variante simplifiée de gdImageColorExactAlpha où le canal alpha est toujours opaque.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
Retour
| Valeur |
Description |
| Entier |
La couleur exacte déjà disponible dans la palette pour les images de palette ; s'il n'y a pas de couleur exacte, -1 est renvoyé. Pour les images en vraies couleurs, la valeur de couleur des composants donnés est renvoyée. |
Voir également
gdImageColorExactAlpha
|
int gdImageColorExactAlpha(gdImagePtr im, int r, int g, int b, int a);
|
Obtient la couleur exacte de l'image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
Retour
| Valeur |
Description |
| Entier |
La couleur exacte déjà disponible dans la palette pour les images de palette; s'il n'y a pas de couleur exacte, la valeur -1 est renvoyée. Pour les images en vraies couleurs, la valeur de couleur des composants donnés est renvoyée. |
Voir également
- gdImageColorClosestAlpha, gdTrueColorAlpha
gdImageColorAllocate
|
int gdImageColorAllocate(gdImagePtr im, int r, int g, int b);
|
Cette fonction permet d'allouer une couleur.
Il s'agit d'une variante simplifiée de gdImageColorAllocateAlpha où le canal alpha est toujours opaque.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
Retour
| Valeur |
Description |
| Entier |
La valeur de la couleur. |
Voir également
gdImageColorAllocateAlpha
|
int gdImageColorAllocateAlpha(gdImagePtr im, int r, int g, int b, int a);
|
Cette fonction permet d'attribuer une couleur.
Cela est généralement utilisé pour les images de palette, mais peut également être utilisé pour les images en vraies couleurs.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| r |
Ce paramètre permet d'indiquer la valeur de la composante rouge. |
| g |
Ce paramètre permet d'indiquer la valeur de la composante verte. |
| b |
Ce paramètre permet d'indiquer la valeur de la composante bleue. |
Retour
| Valeur |
Description |
| Entier |
La valeur de la couleur. |
Voir également
gdImageColorResolve
|
int gdImageColorResolve(gdImagePtr im, int r, int g, int b);
|
gdImageColorResolve est une alternative au fragment de code :
- if ((color=gdImageColorExact(im,R,G,B)) < 0)
- if ((color=gdImageColorAllocate(im,R,G,B)) < 0)
- color=gdImageColorClosest(im,R,G,B);
dans une seule fonction. Son avantage est qu'il garantit le retour d'un index de couleur en une seule recherche sur la table des couleurs.
gdImageColorResolveAlpha
|
int gdImageColorResolveAlpha(gdImagePtr im, int r, int g, int b, int a);
|
gdImageColorDeallocate
|
void gdImageColorDeallocate(gdImagePtr im, int color);
|
Cette fonction permet de supprimer une entrée de palette.
Il s'agit d'une opération nulle pour les images en vraies couleurs. La fonction ne modifie pas les données de l'image, ni la couleur transparente, ni
aucun autre endroit où cet index de couleur aurait pu être référencé. L'index est marqué comme ouvert et sera également utilisé pour tous les appels ultérieurs à gdImageColorAllocate
ou gdImageColorAllocateAlpha. D'autres index inférieurs peuvent également être ouverts, le premier index ouvert trouvé sera utilisé.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| color |
Ce paramètre permet d'indiquer l'index des palettes. |
Voir également
- gdImageColorAllocate, gdImageColorAllocateAlpha
gdImageColorTransparent
|
void gdImageColorTransparent(gdImagePtr im, int color);
|
Définit la couleur transparente de l'image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| color |
Ce paramètre permet d'indiquer la couleur. |
Voir également
gdImagePaletteCopy
|
void gdImagePaletteCopy(gdImagePtr to, gdImagePtr from);
|
gdImageColorReplace
|
int gdImageColorReplace(gdImagePtr im, int src, int dst);
|
gdImageColorReplaceThreshold
|
int gdImageColorReplaceThreshold(gdImagePtr im, int src, int dst, float threshold);
|
gdImageColorReplaceArray
|
int gdImageColorReplaceArray(gdImagePtr im, int len, int *src, int *dst);
|
gdImageColorReplaceCallback
|
int gdImageColorReplaceCallback(gdImagePtr im, gdCallbackImageColor callback);
|
Pixels
gdImageSetPixel
|
void gdImageSetPixel(gdImagePtr im, int x, int y, int color);
|
gdImageGetPixel
|
int gdImageGetPixel(gdImagePtr im, int x, int y);
|
Obtient une couleur de pixel telle que entreposée dans l'image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| x |
Ce paramètre permet d'indiquer la coordonnée x. |
| y |
Ce paramètre permet d'indiquer la coordonnée y. |
Voir également
- gdImageGetTrueColorPixel, gdImagePalettePixel, gdImageTrueColorPixel
gdImageGetTrueColorPixel
|
int gdImageGetTrueColorPixel(gdImagePtr im, int x, int y);
|
Obtient toujours une couleur de pixel comme valeur de vraie couleur.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| x |
Ce paramètre permet d'indiquer la coordonnée x. |
| y |
Ce paramètre permet d'indiquer la coordonnée y. |
Voir également
- gdImageGetPixel, gdImageTrueColorPixel
Primitives
gdImageAABlend
|
void gdImageAABlend(gdImagePtr im);
|
NO-OP, conservé pour la compatibilité de la bibliothèque.
gdImageLine
|
void gdImageLine(gdImagePtr im, int x1, int y1, int x2, int y2, int color);
|
Bresenham tel que présenté dans Foley & Van Dam.
gdImageDashedLine
|
void gdImageDashedLine(gdImagePtr im, int x1, int y1, int x2, int y2, int color);
|
gdImageBoundsSafe
|
int gdImageBoundsSafe(gdImagePtr im, int x, int y);
|
gdImageChar
|
void gdImageChar(gdImagePtr im, gdFontPtr f, int x, int y, int c, int color);
|
Dessine un seul caractère.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image sur laquelle dessiner. |
| f |
Ce paramètre permet d'indiquer la police de caractères raster. |
| x |
Ce paramètre permet d'indiquer la coordonnée x du pixel supérieur gauche. |
| y |
Ce paramètre permet d'indiquer la coordonnée y du pixel supérieur gauche. |
| c |
Ce paramètre permet d'indiquer le caractère. |
| color |
Ce paramètre permet d'indiquer la couleur. |
Variantes
Voir également
gdImageCharUp
|
void gdImageCharUp(gdImagePtr im, gdFontPtr f, int x, int y, int c, int color);
|
gdImageString
|
void gdImageString(gdImagePtr im, gdFontPtr f, int x, int y, unsigned char *s, int color);
|
Dessine une chaîne de caractères.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image sur laquelle dessiner. |
| f |
Ce paramètre permet d'indiquer la police de caractères raster. |
| x |
Ce paramètre permet d'indiquer la coordonnée x du pixel supérieur gauche. |
| y |
Ce paramètre permet d'indiquer la coordonnée y du pixel supérieur gauche. |
| c |
Ce paramètre permet d'indiquer la chaîne de caractères. |
| color |
Ce paramètre permet d'indiquer la couleur. |
Variantes
- gdImageStringUp, gdImageString16, gdImageStringUp16
Voir également
- gdFontPtr, gdImageStringTTF
gdImageStringUp
|
void gdImageStringUp(gdImagePtr im, gdFontPtr f, int x, int y, unsigned char *s, int color);
|
gdImageString16
|
void gdImageString16(gdImagePtr im, gdFontPtr f, int x, int y, unsigned short *s, int color);
|
gdImageStringUp16
|
void gdImageStringUp16(gdImagePtr im, gdFontPtr f, int x, int y, unsigned short *s, int color);
|
gdImageArc
|
void gdImageArc(gdImagePtr im, int cx, int cy, int w, int h, int s, int e, int color);
|
gdImageFilledArc
|
void gdImageFilledArc(gdImagePtr im, int cx, int cy, int w, int h, int s, int e, int color, int style);
|
gdImageEllipse
|
void gdImageEllipse(gdImagePtr im, int mx, int my, int w, int h, int c);
|
gdImageFilledEllipse
|
void gdImageFilledEllipse(gdImagePtr im, int mx, int my, int w, int h, int c);
|
gdImageFillToBorder
|
void gdImageFillToBorder(gdImagePtr im, int x, int y, int border, int color);
|
gdImageFill
|
void gdImageFill(gdImagePtr im, int x, int y, int nc);
|
gdImageRectangle
|
void gdImageRectangle(gdImagePtr im, int x1, int y1, int x2, int y2, int color);
|
Dessine un rectangle.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| x1 |
Ce paramètre permet d'indiquer la coordonnée x de l'un des coins. |
| y1 |
Ce paramètre permet d'indiquer la coordonnée y de l'un des coins. |
| x2 |
Ce paramètre permet d'indiquer la coordonnée x d'un autre coin. |
| y2 |
Ce paramètre permet d'indiquer la coordonnée y d'un autre coin. |
| color |
Ce paramètre permet d'indiquer la couleur. |
Voir également
gdImageFilledRectangle
|
void gdImageFilledRectangle(gdImagePtr im, int x1, int y1, int x2, int y2, int color);
|
Clonage et copie
gdImageClone
|
gdImagePtr gdImageClone(gdImagePtr src);
|
Cette fonction permet de cloner une image.
Crée une copie exacte de l'image donnée.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer l'image source. |
Retour
| Valeur |
Description |
| Pointeur |
L'image clonée en cas de succès, NULL en cas d'échec. |
gdImageCopy
|
void gdImageCopy(gdImagePtr dst, gdImagePtr src, int dstX, int dstY, int srcX, int srcY, int w, int h);
|
Copier une zone d'une image vers une autre image.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer l'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche vers lequel copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche vers lequel copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| w |
Ce paramètre permet d'indiquer la largeur de la zone à copier. |
| h |
Ce paramètre permet d'indiquer la hauteur de la zone à copier. |
Voir également
- gdImageCopyMerge, gdImageCopyMergeGray
gdImageCopyMerge
|
void gdImageCopyMerge(gdImagePtr dst, gdImagePtr src, int dstX, int dstY, int srcX, int srcY, int w, int h, int pct);
|
Copier une zone d'une image vers une autre image en ignorant l'alpha.
La zone source sera copiée vers la zone de destination en fusionnant les pixels.
Remarque
Cette fonction est un substitut aux opérations réelles de canal alpha, elle ne tient donc pas compte du canal alpha.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer L'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche vers lequel copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche vers lequel copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| w |
Ce paramètre permet d'indiquer la largeur de la zone à copier. |
| h |
Ce paramètre permet d'indiquer la hauteur de la zone à copier. |
| pct |
Ce paramètre permet d'indiquer le pourcentage dans l'intervalle de 0 à 100. |
Voir également
- gdImageCopy, gdImageCopyMergeGray
gdImageCopyMergeGray
|
void gdImageCopyMergeGray(gdImagePtr dst, gdImagePtr src, int dstX, int dstY, int srcX, int srcY, int w, int h, int pct);
|
Copier une zone d'une image vers une autre image en ignorant l'alpha.
La zone source sera copiée vers la zone de destination en niveaux de gris en fusionnant les pixels.
Remarque
Cette fonction est un substitut aux opérations réelles du canal alpha, elle ne tient donc pas compte du canal alpha.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer l'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche vers lequel copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche vers lequel copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| w |
Ce paramètre permet d'indiquer la largeur de la zone à copier. |
| h |
Ce paramètre permet d'indiquer la hauteur de la zone à copier. |
| pct |
Ce paramètre permet d'indiquer le pourcentage de l'intensité de la couleur source dans l'intervalle 0 à 100. |
Voir également
- gdImageCopy, gdImageCopyMerge
gdImageCopyResized
|
void gdImageCopyResized(gdImagePtr dst, gdImagePtr src, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH);
|
Copier une zone redimensionnée d'une image vers une autre image.
Si la taille de la zone source et de la zone de destination est différente, la zone sera redimensionnée à l'aide de l'interpolation du voisin le
plus proche.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer l'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche vers lequel copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche vers lequel copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| dstW |
Ce paramètre permet d'indiquer la largeur de la zone à copier. |
| dstH |
Ce paramètre permet d'indiquer la hauteur de la zone à copier. |
| srcW |
Ce paramètre permet d'indiquer la largeur de la zone à partir de laquelle copier. |
| srcH |
Ce paramètre permet d'indiquer la hauteur de la zone à partir de laquelle copier. |
Voir également
- gdImageCopyResampled, gdImageScale
gdImageCopyRotated
|
void gdImageCopyRotated(gdImagePtr dst, gdImagePtr src, double dstX, double dstY, int srcX, int srcY, int srcWidth, int srcHeight, int angle);
|
Copier une zone pivotée d'une image vers une autre image.
La zone est pivotée dans le sens inverse des aiguilles d'une montre à l'aide de l'interpolation du voisin le plus proche.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer l'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du centre de la zone à copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du centre de la zone à copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| srcW |
Ce paramètre permet d'indiquer la largeur de la zone à partir de laquelle copier. |
| srcH |
Ce paramètre permet d'indiquer la hauteur de la zone à partir de laquelle copier. |
| angle |
Ce paramètre permet d'indiquer l'angle en degrés. |
Voir également
- gdImageRotateInterpolated
gdImageCopyResampled
|
void gdImageCopyResampled(gdImagePtr dst, gdImagePtr src, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH);
|
Copier une zone rééchantillonnée d'une image vers une autre image.
Si la taille de la zone source et de la zone de destination diffère, la zone sera redimensionnée à l'aide d'une interpolation bilinéaire pour les
images en vraies couleurs et d'une interpolation par le plus proche voisin pour les images en palette.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer l'image de destination. |
| src |
Ce paramètre permet d'indiquer l'image source. |
| dstX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche vers lequel copier. |
| dstY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche vers lequel copier. |
| srcX |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche à partir duquel copier. |
| srcY |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche à partir duquel copier. |
| dstW |
Ce paramètre permet d'indiquer la largeur de la zone à copier. |
| dstH |
Ce paramètre permet d'indiquer la hauteur de la zone à copier. |
| srcW |
Ce paramètre permet d'indiquer la largeur de la zone à partir de laquelle copier. |
| srcH |
Ce paramètre permet d'indiquer la hauteur de la zone à partir de laquelle copier. |
Voir également
- gdImageCopyResized, gdImageScale
Polygones
gdImagePolygon
|
void gdImagePolygon(gdImagePtr im, gdPointPtr p, int n, int c);
|
Dessine un polygone fermé.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| p |
Ce paramètre permet d'indiquer les sommets sous forme de tableau de gdPoints. |
| n |
Ce paramètre permet d'indiquer le nombre de sommets. |
| c |
Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdImageOpenPolygon, gdImageFilledPolygon
gdImageOpenPolygon
|
void gdImageOpenPolygon(gdImagePtr im, gdPointPtr p, int n, int c);
|
Dessine un polygone ouvert.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| p |
Ce paramètre permet d'indiquer les sommets sous forme de tableau de gdPoints. |
| n |
Ce paramètre permet d'indiquer le nombre de sommets. |
| c |
Ce paramètre permet d'indiquer la couleur. |
Voir également
gdImageFilledPolygon
|
void gdImageFilledPolygon(gdImagePtr im, gdPointPtr p, int n, int c);
|
Dessine un polygone rempli.
Le polygone est rempli à l'aide de la règle de remplissage pair-impair, ce qui peut laisser des régions vides à l'intérieur de polygones se croisant.
Ce comportement pourrait changer dans une future version.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| p |
Ce paramètre permet d'indiquer les sommets sous forme de tableau de gdPoints. |
| n |
Ce paramètre permet d'indiquer le nombre de sommets. |
| c |
Ce paramètre permet d'indiquer la couleur. |
Voir également
Autres
gdImageSetStyle
|
void gdImageSetStyle(gdImagePtr im, int *style, int noOfPixels);
|
Définit le style pour les opérations de dessin suivantes.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| style |
Ce paramètre permet d'indiquer un tableau de valeurs de couleur. |
| noOfPixel |
Ce paramètre permet d'indiquer le nombre de valeurs de couleur. |
gdImageSetThickness
|
void gdImageSetThickness(gdImagePtr im, int thickness);
|
Définit l'épaisseur pour les opérations de dessin suivantes.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| thickness |
Ce paramètre permet d'indiquer l'épaisseur en pixels. |
gdImageSetBrush
|
void gdImageSetBrush(gdImagePtr im, gdImagePtr brush);
|
Définit le pinceau pour les opérations de dessin suivantes.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| brush |
Ce paramètre permet d'indiquer l'image du pinceau. |
gdImageSetTile
|
void gdImageSetTile(gdImagePtr im, gdImagePtr tile);
|
gdImageSetAntiAliased
|
void gdImageSetAntiAliased(gdImagePtr im, int c);
|
Définir la couleur pour le dessin anti-crénelé ultérieur.
Si gdAntiAliased est transmis comme couleur aux opérations de dessin prenant en charge le dessin anti-crénelé (comme gdImageLine et
gdImagePolygon), la couleur réelle à utiliser peut être définie avec cette fonction.
Exemple : dessiner une ligne bleue anti-crénelée :
- gdImageSetAntiAliased(im, gdTrueColorAlpha(0, 0, gdBlueMax, gdAlphaOpaque));
- gdImageLine(im, 10,10, 20,20, gdAntiAliased);
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| c |
Ce paramètre permet d'indiquer la couleur. |
Voir également
- gdImageSetAntiAliasedDontBlend
gdImageSetAntiAliasedDontBlend
|
void gdImageSetAntiAliasedDontBlend(gdImagePtr im, int c, int dont_blend);
|
Définissez la couleur et la couleur «dont_blend» pour le dessin anti-aliasé ultérieur.
Cette variante étendue de gdImageSetAntiAliased permet également de spécifier une couleur (d'arrière-plan) qui ne sera pas mélangée dans
les opérations de dessin anti-aliasé.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| c |
Ce paramètre permet d'indiquer la couleur. |
| dont_blend |
Ce paramètre permet d'indiquer s'il faut le mélanger. |
gdImageInterlace
|
void gdImageInterlace(gdImagePtr im, int interlaceArg);
|
Définit si une image est entrelacée.
Cela n'est pertinent que lors de l'enregistrement de l'image dans un format qui prend en charge l'entrelacement.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| interlaceArg |
Ce paramètre permet d'indiquer si l'image est entrelacée. |
Voir également
gdImageCompare
|
int gdImageCompare(gdImagePtr im1, gdImagePtr im2);
|
Comparer deux images.
Paramètre
| Nom |
Description |
| im1 |
Ce paramètre permet d'indiquer une image. |
| im2 |
Ce paramètre permet d'indiquer une autre image. |
Retour
| Valeur |
Description |
| Entier |
Un masque de bits d'indicateurs de comparaison d'images où chaque indicateur défini signale quels attributs des images sont différents. |
gdAlphaBlend
|
int gdAlphaBlend(int dst, int src);
|
Mélanger deux couleurs.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer la couleur à mélanger. |
| src |
La couleur à mélanger. |
Voir également
- gdImageAlphaBlending, gdLayerOverlay, gdLayerMultiply
gdLayerOverlay
|
int gdLayerOverlay(int dst, int src);
|
Superposer deux couleurs.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer la couleur à superposer sur la destination. |
| src |
Ce paramètre permet d'indiquer la couleur à superposer. |
Voir également
- gdImageAlphaBlending, gdAlphaBlend, gdLayerMultiply
gdLayerMultiply
|
int gdLayerMultiply(int dst, int src);
|
Superposer deux couleurs avec effet multiplicateur.
Paramètre
| Nom |
Description |
| dst |
Ce paramètre permet d'indiquer la couleur à superposer sur la destination. |
| src |
Ce paramètre permet d'indiquer la couleur à superposer. |
Voir également
- gdImageAlphaBlending, gdAlphaBlend, gdLayerOverlay
gdImageAlphaBlending
|
void gdImageAlphaBlending(gdImagePtr im, int alphaBlendingArg);
|
Définissez l'effet pour les opérations de dessin ultérieures.
Notez que l'effet est utilisé uniquement pour les images en vraies couleurs.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| alphaBlendingArg |
Ce paramètre permet d'indiquer l'effet. |
Voir également
gdImageSaveAlpha
|
void gdImageSaveAlpha(gdImagePtr im, int saveAlphaArg)
|
Définit l'indicateur d'enregistrement alpha.
L'indicateur d'enregistrement alpha spécifie si le canal alpha des pixels doit être enregistré. Cette option n'est prise en charge que pour les
formats d'image prenant en charge la transparence alpha complète, par exemple PNG.
gdImageSetClip
|
void gdImageSetClip(gdImagePtr im, int x1, int y1, int x2, int y2);
|
Définit le rectangle de découpage.
Le rectangle de découpage restreint la zone de dessin pour les opérations de dessin suivantes.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| x1 |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche. |
| y1 |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche. |
| x2 |
Ce paramètre permet d'indiquer la coordonnée x du coin inférieur droit. |
| y2 |
Ce paramètre permet d'indiquer la coordonnée y du coin inférieur droit. |
Voir également
gdImageGetClip
|
void gdImageGetClip(gdImagePtr im, int *x1P, int *y1P, int *x2P, int *y2P);
|
Obtient le rectangle de découpage actuel.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| x1P (out) |
Ce paramètre permet d'indiquer la coordonnée x du coin supérieur gauche. |
| y1P (out) |
Ce paramètre permet d'indiquer la coordonnée y du coin supérieur gauche. |
| x2P (out) |
Ce paramètre permet d'indiquer la coordonnée x du coin inférieur droit. |
| y2P (out) |
Ce paramètre permet d'indiquer la coordonnée y du coin inférieur droit. |
Voir également
gdImageSetResolution
|
void gdImageSetResolution(gdImagePtr im, const unsigned int res_x, const unsigned int res_y);
|
Définit la résolution d'une image.
Paramètre
| Nom |
Description |
| im |
Ce paramètre permet d'indiquer l'image. |
| res_x |
Ce paramètre permet d'indiquer La résolution horizontale en DPI. |
| res_y |
Ce paramètre permet d'indiquer la résolution verticale en DPI. |
Voir également
- gdImageResolutionX, gdImageResolutionY
gdImagePaletteToTrueColor
|
int gdImagePaletteToTrueColor(gdImagePtr src)
|
Convertir une image de palette en vraies couleurs.
Paramètre
| Nom |
Description |
| src |
Ce paramètre permet d'indiquer l'image. |
Retour
| Valeur |
Description |
| Entier |
Différent de zéro si la conversion a réussi, zéro sinon. |
Voir également
- gdImageTrueColorToPalette
Dernière mise à jour : Dimanche, le 26 janvier 2025
