module gd

Le module gd est un module de traitement d'image. Il fournit les fonctions de création, d'exploitation et de stockage d'images, et fournit une richesse de couleurs, de filtres, de dessins et d'autres opérations connexes.

Voici un exemple de code qui utilise le module gd pour créer et manipuler une image :

1
2
3
4
5
6
7
8
9
10
var gd = require('gd');

var img = gd.create(440, 240); // create a 440x240 truecolor image

var r = img.colorAllocate(255, 0, 0); // allocate two colors
var b = img.colorAllocate(0, 0, 255);
img.rectangle(40, 40, 50, 50, r); // draw a rectangle
img.filledEllipse(80, 100, 30, 50, b); // fill a ellipse

var data = img.getData(gd.PNG); // save image as PNG data

Dans cet exemple, nous utilisons d'abord la méthode create() pour créer une image TRUECOLOR 440x240, puis utilisons la méthode colorAllocate() pour attribuer deux couleurs, puis utilisons la méthode rectangle() pour dessiner un rectangle et dessinons une Ellipse remplie, et utilisez enfin la méthode getData() pour enregistrer l'image sous forme de données binaires au format PNG.

fonction statique

create

Créer une nouvelle image

1
2
3
static Image gd.create(Integer width,
    Integer height,
    Integer color = gd.TRUECOLOR) async;

Paramètres d'appel :

width: Entier, spécifiez la largeur de l'image
height: Entier, précisez la hauteur de l'image
color: Entier, précise le type d'image, les valeurs autorisées sontgd.TRUECOLORougd.PALETTE

Résultats de retour :

Image, renvoie l'objet image créé avec succès

load

Décoder l'image à partir des données de format

1
static Image gd.load(Buffer data) async;

Paramètres d'appel :

data:Buffer, étant donné les données d'image décodées

Résultats de retour :

Image, renvoie l'objet image décodé avec succès

Décoder l'image à partir de l'objet flux

1
static Image gd.load(SeekableStream stm) async;

Paramètres d'appel :

stm:SeekableStream, l'objet de flux où se trouvent les données d'image données

Résultats de retour :

Image, renvoie l'objet image décodé avec succès

Décoder une image à partir du fichier spécifié

1
static Image gd.load(String fname) async;

Paramètres d'appel :

fname: Chaîne, spécifiez le nom du fichier

Résultats de retour :

Image, renvoie l'objet image décodé avec succès

rgb

Générer des couleurs combinées à partir de composants de couleur RVB

1
2
3
static Integer gd.rgb(Integer red,
    Integer green,
    Integer blue);

Paramètres d'appel :

red: Entier, composante rouge, plage comprise entre 0 et 255
green: Entier, composante verte, plage comprise entre 0 et 255
blue: Entier, composante bleue, plage comprise entre 0 et 255

Résultats de retour :

Integer, renvoie la couleur combinée

rgba

Générer des couleurs combinées à partir des composants de couleur rgba

1
2
3
4
static Integer gd.rgba(Integer red,
    Integer green,
    Integer blue,
    Number alpha);

Paramètres d'appel :

red: Entier, composante rouge, plage comprise entre 0 et 255
green: Entier, composante verte, plage comprise entre 0 et 255
blue: Entier, composante bleue, plage comprise entre 0 et 255
alpha: Nombre, composant transparent, plage comprise entre 0,0 et 1,0

Résultats de retour :

Integer, renvoie la couleur combinée

hsl

Générer des couleurs combinées à partir de composants de couleur HSL

1
2
3
static Integer gd.hsl(Number hue,
    Number saturation,
    Number lightness);

Paramètres d'appel :

hue: Nombre, composante de teinte, plage de 0 à 360
saturation: Nombre, composant de saturation, plage de 0,0 à 1,0
lightness: Nombre, composante de luminosité, plage de 0,0 à 1,0

Résultats de retour :

Integer, renvoie la couleur combinée

hsla

Générer des couleurs combinées à partir des composants de couleur HSLA

1
2
3
4
static Integer gd.hsla(Number hue,
    Number saturation,
    Number lightness,
    Number alpha);

Paramètres d'appel :

hue: Nombre, composante de teinte, plage de 0 à 360
saturation: Nombre, composant de saturation, plage de 0,0 à 1,0
lightness: Nombre, composante de luminosité, plage de 0,0 à 1,0
alpha: Nombre, composant transparent, plage comprise entre 0,0 et 1,0

Résultats de retour :

Integer, renvoie la couleur combinée

hsb

Générer des couleurs combinées à partir des composants de couleur HSB

1
2
3
static Integer gd.hsb(Number hue,
    Number saturation,
    Number brightness);

Paramètres d'appel :

hue: Nombre, composante de teinte, plage de 0 à 360
saturation: Nombre, composant de saturation, plage de 0,0 à 1,0
brightness: Nombre, composante de luminosité, plage de 0,0 à 1,0

Résultats de retour :

Integer, renvoie la couleur combinée

hsba

Générer des couleurs combinées à partir des composants de couleur HSBA

1
2
3
4
static Integer gd.hsba(Number hue,
    Number saturation,
    Number brightness,
    Number alpha);

Paramètres d'appel :

hue: Nombre, composante de teinte, plage de 0 à 360
saturation: Nombre, composant de saturation, plage de 0,0 à 1,0
brightness: Nombre, composante de luminosité, plage de 0,0 à 1,0
alpha: Nombre, composant transparent, plage comprise entre 0,0 et 1,0

Résultats de retour :

Integer, renvoie la couleur combinée

color

Générer des couleurs combinées à partir d'une chaîne

1
static Integer gd.color(String color);

Paramètres d'appel :

color: String, une chaîne spécifiant la couleur, telle que : "#ff0000", "ff0000", "#f00", "f00"

Résultats de retour :

Integer, renvoie la couleur combinée

constante

NONE

Format d'image constant, indiquant que la source d'image actuelle est inconnue

1
const gd.NONE = 0;

JPEG

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format JPEG

1
const gd.JPEG = 1;

GIF

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format GIF

1
const gd.GIF = 2;

PNG

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format png

1
const gd.PNG = 3;

TIFF

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format tiff

1
const gd.TIFF = 4;

BMP

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format bmp

1
const gd.BMP = 5;

WEBP

Constante de format d'image, indiquant que la source d'image actuelle est constituée de données au format Webp

1
const gd.WEBP = 6;

TRUECOLOR

Constante de type d’image, indiquant que l’image actuelle est une image en vraies couleurs

1
const gd.TRUECOLOR = 0;

PALETTE

Constante de type d'image, indiquant que l'image actuelle est une image de palette

1
const gd.PALETTE = 1;

ARC

Style de dessin de secteur, dessine un arc reliant les points de début et de fin

1
const gd.ARC = 0;

CHORD

Style de dessin de secteur, tracez une ligne droite reliant les points d'origine, de début et de fin

1
const gd.CHORD = 1;

NOFILL

Style de dessin de secteur, dessine un secteur sans remplissage

1
const gd.NOFILL = 2;

EDGED

Style de dessin de secteur, tracez un arc reliant le point de départ et le point final et une ligne droite reliant l'origine

1
const gd.EDGED = 4;

HORIZONTAL

Direction de mise en miroir, traitement de mise en miroir horizontale

1
const gd.HORIZONTAL = 1;

VERTICAL

Direction du miroir, traitement du miroir vertical

1
const gd.VERTICAL = 2;

BOTH

Direction de mise en miroir, traitement de mise en miroir horizontal et vertical

1
const gd.BOTH = 3;

LEFT

Sens de rotation, tourner à gauche

1
const gd.LEFT = 1;

RIGHT

Sens de rotation, tourner à droite

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Type de filtre : utilisez la méthode de suppression moyenne pour obtenir un effet de contour.

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Type de filtre : utilisez la détection des contours pour mettre en évidence les bords de l'image

1
const gd.EDGEDETECT = 1;

EMBOSS

Type de filtre : gaufrer l'image

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Type de filtre : Image floue

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Type de filtre : Image floue avec algorithme gaussien

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Type de filtre : Inverser toutes les couleurs de l'image

1
const gd.NEGATE = 5;

GRAYSCALE

Type de filtre : Convertir l'image en niveaux de gris

1
const gd.GRAYSCALE = 6;

SMOOTH

Type de filtre : rend l'image plus lisse, utilisez arg1 pour définir le niveau de douceur

1
const gd.SMOOTH = 7;

BRIGHTNESS

Type de filtre : modifiez la luminosité de l'image, utilisez arg1 pour définir le niveau de luminosité, la plage de valeurs est de -255 à 255.

1
const gd.BRIGHTNESS = 8;

CONTRAST

Type de filtre : modifiez le contraste de l'image, utilisez arg1 pour définir le niveau de contraste, la plage de valeurs est de 0 à 100.

1
const gd.CONTRAST = 9;

COLORIZE

Type de filtre : modifiez la teinte de l'image. Utilisez arg1, arg2 et arg3 pour spécifier respectivement le rouge, le bleu et le vert. La plage de chaque couleur est comprise entre 0 et 255. arg4 correspond à la transparence et la valeur renvoyée est comprise entre 0 et 127.

1
const gd.COLORIZE = 10;

Guide de développement

Module de base

objets intégrés

module communautaire

module gd

fonction statique

create

load

rgb

rgba

hsl

hsla

hsb

hsba

color

constante

NONE

JPEG

GIF

PNG

TIFF

BMP

WEBP

TRUECOLOR

PALETTE

ARC

CHORD

NOFILL

EDGED

HORIZONTAL

VERTICAL

BOTH

LEFT

RIGHT

MEAN_REMOVAL

EDGEDETECT

EMBOSS

SELECTIVE_BLUR

GAUSSIAN_BLUR

NEGATE

GRAYSCALE

SMOOTH

BRIGHTNESS

CONTRAST

COLORIZE