módulo gd

El módulo gd es un módulo para el procesamiento de imágenes que proporciona las funciones de creación, operación y almacenamiento de imágenes, y proporciona una gran cantidad de colores, filtros, dibujos y otras operaciones relacionadas.

Aquí hay un código de muestra que usa el módulo gd para crear y manipular una imagen:

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 este ejemplo, primero usamos el método create() para crear una imagen TRUECOLOR de 440x240 y usamos el método colorAllocate() para asignar dos colores, luego usamos el método rectángulo() para dibujar un rectángulo y dibujar una elipse rellena, y finalmente use el método getData() para guardar la imagen como datos binarios en formato PNG.

función estática

create

Crea una nueva imagen

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

Parámetros de llamada:

width: Entero, especifique el ancho de la imagen
height: Entero, especifica la altura de la imagen.
color: Entero, especifica el tipo de imagen, los valores permitidos songd.TRUECOLORogd.PALETTE

Resultados de devolución:

Image, devuelve el objeto de imagen creado correctamente

load

Decodificar imagen a partir de datos de formato

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

Parámetros de llamada:

data:Buffer, dados los datos de la imagen decodificada

Resultados de devolución:

Image, devuelve el objeto de imagen decodificado correctamente

Decodificar imagen del objeto de flujo

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

Parámetros de llamada:

stm:SeekableStream, el objeto de flujo donde se encuentran los datos de imagen dados

Resultados de devolución:

Image, devuelve el objeto de imagen decodificado correctamente

Decodificar una imagen del archivo especificado

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

Parámetros de llamada:

fname: Cadena, especifique el nombre del archivo

Resultados de devolución:

Image, devuelve el objeto de imagen decodificado correctamente

rgb

Genere colores combinados a partir de componentes de color rgb.

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

Parámetros de llamada:

red: Entero, componente rojo, el rango es 0-255
green: Entero, componente verde, el rango es 0-255
blue: Entero, componente azul, el rango es 0-255

Resultados de devolución:

Integer, devuelve el color combinado

rgba

Genere colores combinados a partir de componentes de color rgba

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

Parámetros de llamada:

red: Entero, componente rojo, el rango es 0-255
green: Entero, componente verde, el rango es 0-255
blue: Entero, componente azul, el rango es 0-255
alpha: Número, componente transparente, el rango es 0,0-1,0

Resultados de devolución:

Integer, devuelve el color combinado

hsl

Genere colores combinados a partir de componentes de color hsl

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

Parámetros de llamada:

hue: Número, componente de tono, el rango es 0-360
saturation: Número, componente de saturación, el rango es 0,0-1,0
lightness: Número, componente de brillo, el rango es 0,0-1,0

Resultados de devolución:

Integer, devuelve el color combinado

hsla

Genere colores combinados a partir de componentes de color hsla

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

Parámetros de llamada:

hue: Número, componente de tono, el rango es 0-360
saturation: Número, componente de saturación, el rango es 0,0-1,0
lightness: Número, componente de brillo, el rango es 0,0-1,0
alpha: Número, componente transparente, el rango es 0,0-1,0

Resultados de devolución:

Integer, devuelve el color combinado

hsb

Genere colores combinados a partir de componentes de color hsb

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

Parámetros de llamada:

hue: Número, componente de tono, el rango es 0-360
saturation: Número, componente de saturación, el rango es 0,0-1,0
brightness: Número, componente de brillo, el rango es 0,0-1,0

Resultados de devolución:

Integer, devuelve el color combinado

hsba

Genere colores combinados a partir de componentes de color hsba

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

Parámetros de llamada:

hue: Número, componente de tono, el rango es 0-360
saturation: Número, componente de saturación, el rango es 0,0-1,0
brightness: Número, componente de brillo, el rango es 0,0-1,0
alpha: Número, componente transparente, el rango es 0,0-1,0

Resultados de devolución:

Integer, devuelve el color combinado

color

Generar colores combinados a partir de una cadena.

1
static Integer gd.color(String color);

Parámetros de llamada:

color: Cadena, una cadena que especifica el color, como por ejemplo: "#ff0000", "ff0000", "#f00", "f00"

Resultados de devolución:

Integer, devuelve el color combinado

constante

NONE

Constante de formato de imagen, que indica que se desconoce la fuente de la imagen actual

1
const gd.NONE = 0;

JPEG

Constante de formato de imagen, que indica que la fuente de la imagen actual son datos en formato jpeg

1
const gd.JPEG = 1;

GIF

Constante de formato de imagen, que indica que la fuente de la imagen actual son datos en formato gif

1
const gd.GIF = 2;

PNG

Constante de formato de imagen, que indica que la fuente de la imagen actual son datos en formato png

1
const gd.PNG = 3;

TIFF

Constante de formato de imagen, que indica que la fuente de la imagen actual son datos en formato tiff

1
const gd.TIFF = 4;

BMP

Constante de formato de imagen, que indica que la fuente de imagen actual son datos en formato bmp

1
const gd.BMP = 5;

WEBP

Constante de formato de imagen, que indica que la fuente de la imagen actual son datos en formato webp

1
const gd.WEBP = 6;

TRUECOLOR

Constante de tipo de imagen, que indica que la imagen actual es una imagen en color verdadero

1
const gd.TRUECOLOR = 0;

PALETTE

Constante de tipo de imagen, que indica que la imagen actual es una imagen de paleta

1
const gd.PALETTE = 1;

ARC

Estilo de dibujo de sector, dibuja un arco que conecta los puntos inicial y final.

1
const gd.ARC = 0;

CHORD

Estilo de dibujo de sector, dibuja una línea recta que conecta los puntos de origen, inicio y final.

1
const gd.CHORD = 1;

NOFILL

Estilo de dibujo de sector, dibuja un sector sin relleno.

1
const gd.NOFILL = 2;

EDGED

Estilo de dibujo de sector, dibuja un arco que conecta el punto inicial y el punto final y una línea recta que conecta el origen.

1
const gd.EDGED = 4;

HORIZONTAL

Dirección de espejo, procesamiento de espejo horizontal

1
const gd.HORIZONTAL = 1;

VERTICAL

Dirección del espejo, procesamiento de espejo vertical.

1
const gd.VERTICAL = 2;

BOTH

Dirección de espejo, procesamiento de espejo horizontal y vertical

1
const gd.BOTH = 3;

LEFT

Dirección de rotación, girar a la izquierda.

1
const gd.LEFT = 1;

RIGHT

Dirección de rotación, girar a la derecha.

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Tipo de filtro: use un método de eliminación promedio para lograr un efecto de contorno

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Tipo de filtro: utilice la detección de bordes para resaltar los bordes de la imagen.

1
const gd.EDGEDETECT = 1;

EMBOSS

Tipo de filtro: imagen en relieve

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Tipo de filtro: Imagen borrosa

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Tipo de filtro: Imagen desenfocada con algoritmo gaussiano

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Tipo de filtro: invertir todos los colores de la imagen

1
const gd.NEGATE = 5;

GRAYSCALE

Tipo de filtro: convertir imagen a escala de grises

1
const gd.GRAYSCALE = 6;

SMOOTH

Tipo de filtro: haga la imagen más suave, use arg1 para establecer el nivel de suavidad

1
const gd.SMOOTH = 7;

BRIGHTNESS

Tipo de filtro: cambie el brillo de la imagen, use arg1 para establecer el nivel de brillo, el rango de valores es -255 ~ 255

1
const gd.BRIGHTNESS = 8;

CONTRAST

Tipo de filtro: cambie el contraste de la imagen, use arg1 para establecer el nivel de contraste, el rango de valores es 0 ~ 100

1
const gd.CONTRAST = 9;

COLORIZE

Tipo de filtro: cambie el tono de la imagen. Utilice arg1, arg2 y arg3 para especificar rojo, azul y verde respectivamente. El rango de cada color es 0 ~ 255. arg4 es transparencia y el valor devuelto es 0 ~ 127.

1
const gd.COLORIZE = 10;

Guía de desarrollo

Módulo básico

objetos incorporados

módulo comunitario

módulo gd

función estática

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