mòdul gd

El mòdul gd és un mòdul de processament d'imatges que ofereix les funcions de creació, operació i emmagatzematge d'imatges, i ofereix una gran quantitat de colors, filtres, dibuixos i altres operacions relacionades.

Aquí teniu un codi de mostra que utilitza el mòdul gd per crear i manipular una imatge:

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

En aquest exemple, primer utilitzem el mètode create() per crear una imatge TRUECOLOR de 440 x 240, i utilitzem el mètode colorAllocate() per assignar dos colors, després utilitzem el mètode rectangle() per dibuixar un rectangle i dibuixem una el·lipse plena i finalment utilitzeu el mètode getData() per desar la imatge com a dades binàries en format PNG.

funció estàtica

create

Crea una imatge nova

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

Paràmetres de trucada:

width: Sencer, especifiqueu l'amplada de la imatge
height: Sencer, especifiqueu l'alçada de la imatge
color: Enter, especifica el tipus d'imatge, els valors permesos sóngd.TRUECOLORogd.PALETTE

Resultats de retorn:

Image, retorna l'objecte d'imatge creat correctament

load

Descodificar la imatge a partir de dades de format

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

Paràmetres de trucada:

data:Buffer, donades les dades de la imatge descodificada

Resultats de retorn:

Image, retorna l'objecte d'imatge descodificat correctament

Descodificar la imatge de l'objecte de flux

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

Paràmetres de trucada:

stm:SeekableStream, l'objecte de flux on es troben les dades de la imatge donades

Resultats de retorn:

Image, retorna l'objecte d'imatge descodificat correctament

Descodificar una imatge del fitxer especificat

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

Paràmetres de trucada:

fname: Cadena, especifiqueu el nom del fitxer

Resultats de retorn:

Image, retorna l'objecte d'imatge descodificat correctament

rgb

Genereu colors combinats a partir de components de color rgb

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

Paràmetres de trucada:

red: Sencer, component vermell, interval és de 0 a 255
green: Sencer, component verd, el rang és 0-255
blue: Sencer, component blau, el rang és 0-255

Resultats de retorn:

Integer, retorna el color combinat

rgba

Genereu colors combinats a partir de components de color rgba

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

Paràmetres de trucada:

red: Sencer, component vermell, interval és de 0 a 255
green: Sencer, component verd, el rang és 0-255
blue: Sencer, component blau, el rang és 0-255
alpha: Nombre, component transparent, rang és 0,0-1,0

Resultats de retorn:

Integer, retorna el color combinat

hsl

Genereu colors combinats a partir de components de color hsl

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

Paràmetres de trucada:

hue: nombre, component de tonalitat, interval és de 0 a 360
saturation: Nombre, component de saturació, rang és 0,0-1,0
lightness: Nombre, component de brillantor, rang és de 0,0-1,0

Resultats de retorn:

Integer, retorna el color combinat

hsla

Genereu colors combinats a partir de components de color hsla

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

Paràmetres de trucada:

hue: nombre, component de tonalitat, interval és de 0 a 360
saturation: Nombre, component de saturació, rang és 0,0-1,0
lightness: Nombre, component de brillantor, rang és de 0,0-1,0
alpha: Nombre, component transparent, rang és 0,0-1,0

Resultats de retorn:

Integer, retorna el color combinat

hsb

Genereu colors combinats a partir de components de color hsb

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

Paràmetres de trucada:

hue: nombre, component de tonalitat, interval és de 0 a 360
saturation: Nombre, component de saturació, rang és 0,0-1,0
brightness: Nombre, component de brillantor, rang és de 0,0-1,0

Resultats de retorn:

Integer, retorna el color combinat

hsba

Genereu colors combinats a partir de components de color hsba

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

Paràmetres de trucada:

hue: nombre, component de tonalitat, interval és de 0 a 360
saturation: Nombre, component de saturació, rang és 0,0-1,0
brightness: Nombre, component de brillantor, rang és de 0,0-1,0
alpha: Nombre, component transparent, rang és 0,0-1,0

Resultats de retorn:

Integer, retorna el color combinat

color

Genereu colors combinats a partir d'una cadena

1
static Integer gd.color(String color);

Paràmetres de trucada:

color: cadena, una cadena que especifica el color, com ara: "#ff0000", "ff0000", "#f00", "f00"

Resultats de retorn:

Integer, retorna el color combinat

constant

NONE

Format d'imatge constant, que indica que la font actual de la imatge és desconeguda

1
const gd.NONE = 0;

JPEG

Constante de format d'imatge, que indica que la font de la imatge actual són dades de format jpeg

1
const gd.JPEG = 1;

GIF

Constante de format d'imatge, que indica que la font de la imatge actual són dades en format gif

1
const gd.GIF = 2;

PNG

Constante de format d'imatge, que indica que la font de la imatge actual són dades en format png

1
const gd.PNG = 3;

TIFF

Constante de format d'imatge, que indica que la font de la imatge actual és dades de format tiff

1
const gd.TIFF = 4;

BMP

Constante de format d'imatge, que indica que la font de la imatge actual són dades de format bmp

1
const gd.BMP = 5;

WEBP

Constante de format d'imatge, que indica que la font de la imatge actual són dades en format webp

1
const gd.WEBP = 6;

TRUECOLOR

Constante de tipus d'imatge, que indica que la imatge actual és una imatge en color real

1
const gd.TRUECOLOR = 0;

PALETTE

Constante de tipus d'imatge, que indica que la imatge actual és una imatge de paleta

1
const gd.PALETTE = 1;

ARC

Estil de dibuix sectorial, dibuixa un arc que connecta els punts inicial i final

1
const gd.ARC = 0;

CHORD

Estil de dibuix sectorial, dibuixa una línia recta que uneix els punts d'origen, inici i final

1
const gd.CHORD = 1;

NOFILL

Estil de dibuix sectorial, dibuixa un sector sense omplir

1
const gd.NOFILL = 2;

EDGED

Estil de dibuix sectorial, dibuixa un arc que uneix el punt inicial i el punt final i una línia recta que uneix l'origen

1
const gd.EDGED = 4;

HORIZONTAL

Direcció de mirall, processament de mirall horitzontal

1
const gd.HORIZONTAL = 1;

VERTICAL

Direcció del mirall, processament del mirall vertical

1
const gd.VERTICAL = 2;

BOTH

Direcció de mirall, processament de mirall tant horitzontal com vertical

1
const gd.BOTH = 3;

LEFT

Direcció de rotació, gira a l'esquerra

1
const gd.LEFT = 1;

RIGHT

Direcció de rotació, gira a la dreta

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Tipus de filtre: utilitzeu el mètode d'eliminació mitjana per aconseguir un efecte de contorn

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Tipus de filtre: utilitza la detecció de vores per ressaltar les vores de la imatge

1
const gd.EDGEDETECT = 1;

EMBOSS

Tipus de filtre: imatge en relleu

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Tipus de filtre: imatge borrosa

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Tipus de filtre: imatge borrosa amb algorisme gaussià

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Tipus de filtre: inverteix tots els colors de la imatge

1
const gd.NEGATE = 5;

GRAYSCALE

Tipus de filtre: Converteix la imatge a escala de grisos

1
const gd.GRAYSCALE = 6;

SMOOTH

Tipus de filtre: feu que la imatge sigui més suau, utilitzeu arg1 per establir el nivell de suavitat

1
const gd.SMOOTH = 7;

BRIGHTNESS

Tipus de filtre: canvieu la brillantor de la imatge, utilitzeu arg1 per establir el nivell de brillantor, l'interval de valors és de -255 ~ 255

1
const gd.BRIGHTNESS = 8;

CONTRAST

Tipus de filtre: canvieu el contrast de la imatge, utilitzeu arg1 per establir el nivell de contrast, l'interval de valors és de 0 a 100

1
const gd.CONTRAST = 9;

COLORIZE

Tipus de filtre: canvieu la tonalitat de la imatge. Utilitzeu arg1, arg2 i arg3 per especificar el vermell, el blau i el verd respectivament. L'interval de cada color és de 0 a 255. arg4 és transparència i el valor retornat és de 0 a 127.

1
const gd.COLORIZE = 10;

Guia de desenvolupament

Mòdul bàsic

objectes incorporats

mòdul comunitari

mòdul gd

funció estàtica

create

load

rgb

rgba

hsl

hsla

hsb

hsba

color

constant

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