Modulo modulo base

modulo gd

Il modulo gd è un modulo per l'elaborazione delle immagini. Fornisce le funzioni di creazione, utilizzo e archiviazione delle immagini e fornisce una vasta gamma di colori, filtri, disegni e altre operazioni correlate.

Ecco un codice di esempio che utilizza il modulo gd per creare e manipolare un'immagine:

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

In questo esempio, utilizziamo prima il metodo create() per creare un'immagine TRUECOLOR 440x240 e utilizziamo il metodo colorAllocate() per assegnare due colori, quindi utilizziamo il metodo rettangolo() per disegnare un rettangolo e disegnare un'ellisse piena e infine utilizza il metodo getData() per salvare l'immagine come dati binari in formato PNG.

funzione statica

create

Crea una nuova immagine

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

Parametri di chiamata:

  • width: Numero intero, specifica la larghezza dell'immagine
  • height: Numero intero, specifica l'altezza dell'immagine
  • color: intero, specifica il tipo di immagine, i valori consentiti sonogd.TRUECOLOROgd.PALETTE

Risultati restituiti:

  • Image, restituisce l'oggetto immagine creato con successo

load

Decodifica l'immagine dai dati in formato

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

Parametri di chiamata:

  • data:Buffer, dati i dati dell'immagine decodificati

Risultati restituiti:

  • Image, restituisce l'oggetto immagine decodificato correttamente

Decodifica l'immagine dall'oggetto stream

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

Parametri di chiamata:

  • stm:SeekableStream, l'oggetto stream in cui si trovano i dati dell'immagine specificati

Risultati restituiti:

  • Image, restituisce l'oggetto immagine decodificato correttamente

Decodifica un'immagine dal file specificato

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

Parametri di chiamata:

  • fname: Stringa, specifica il nome del file

Risultati restituiti:

  • Image, restituisce l'oggetto immagine decodificato correttamente

rgb

Genera colori combinati da componenti di colore RGB

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

Parametri di chiamata:

  • red: Numero intero, componente rosso, l'intervallo è 0-255
  • green: Numero intero, componente verde, l'intervallo è 0-255
  • blue: Numero intero, componente blu, l'intervallo è 0-255

Risultati restituiti:

  • Integer, restituisce il colore combinato

rgba

Genera colori combinati da componenti di colore RGBA

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

Parametri di chiamata:

  • red: Numero intero, componente rosso, l'intervallo è 0-255
  • green: Numero intero, componente verde, l'intervallo è 0-255
  • blue: Numero intero, componente blu, l'intervallo è 0-255
  • alpha: Numero, componente trasparente, l'intervallo è 0,0-1,0

Risultati restituiti:

  • Integer, restituisce il colore combinato

hsl

Genera colori combinati da componenti di colore HSL

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

Parametri di chiamata:

  • hue: Numero, componente tonalità, l'intervallo è 0-360
  • saturation: Numero, componente di saturazione, l'intervallo è 0,0-1,0
  • lightness: Numero, componente di luminosità, l'intervallo è 0,0-1,0

Risultati restituiti:

  • Integer, restituisce il colore combinato

hsla

Genera colori combinati dai componenti di colore hsla

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

Parametri di chiamata:

  • hue: Numero, componente tonalità, l'intervallo è 0-360
  • saturation: Numero, componente di saturazione, l'intervallo è 0,0-1,0
  • lightness: Numero, componente di luminosità, l'intervallo è 0,0-1,0
  • alpha: Numero, componente trasparente, l'intervallo è 0,0-1,0

Risultati restituiti:

  • Integer, restituisce il colore combinato

hsb

Genera colori combinati dai componenti di colore hsb

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

Parametri di chiamata:

  • hue: Numero, componente tonalità, l'intervallo è 0-360
  • saturation: Numero, componente di saturazione, l'intervallo è 0,0-1,0
  • brightness: Numero, componente di luminosità, l'intervallo è 0,0-1,0

Risultati restituiti:

  • Integer, restituisce il colore combinato

hsba

Genera colori combinati dai componenti di colore hsba

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

Parametri di chiamata:

  • hue: Numero, componente tonalità, l'intervallo è 0-360
  • saturation: Numero, componente di saturazione, l'intervallo è 0,0-1,0
  • brightness: Numero, componente di luminosità, l'intervallo è 0,0-1,0
  • alpha: Numero, componente trasparente, l'intervallo è 0,0-1,0

Risultati restituiti:

  • Integer, restituisce il colore combinato

color

Genera colori combinati dalla stringa

1
static Integer gd.color(String color);

Parametri di chiamata:

  • color: String, una stringa che specifica il colore, come: "#ff0000", "ff0000", "#f00", "f00"

Risultati restituiti:

  • Integer, restituisce il colore combinato

costante

NONE

Costante del formato immagine, che indica che l'origine dell'immagine corrente è sconosciuta

1
const gd.NONE = 0;

JPEG

Costante del formato immagine, che indica che l'origine dell'immagine corrente sono dati in formato jpeg

1
const gd.JPEG = 1;

GIF

Costante del formato immagine, che indica che la sorgente dell'immagine corrente è costituita da dati in formato gif

1
const gd.GIF = 2;

PNG

Costante del formato immagine, che indica che l'origine dell'immagine corrente è costituita da dati in formato PNG

1
const gd.PNG = 3;

TIFF

Costante del formato immagine, che indica che l'origine dell'immagine corrente è costituita da dati in formato tiff

1
const gd.TIFF = 4;

BMP

Costante del formato immagine, che indica che la sorgente dell'immagine corrente sono dati in formato bmp

1
const gd.BMP = 5;

WEBP

Costante del formato immagine, che indica che l'origine dell'immagine corrente sono dati in formato webp

1
const gd.WEBP = 6;

TRUECOLOR

Costante del tipo di immagine, che indica che l'immagine corrente è un'immagine a colori reali

1
const gd.TRUECOLOR = 0;

PALETTE

Costante del tipo di immagine, che indica che l'immagine corrente è un'immagine della tavolozza

1
const gd.PALETTE = 1;

ARC

Stile di disegno a settore: disegna un arco che collega i punti iniziale e finale

1
const gd.ARC = 0;

CHORD

Stile di disegno del settore, traccia una linea retta che collega i punti di origine, inizio e fine

1
const gd.CHORD = 1;

NOFILL

Stile di disegno del settore, disegna un settore senza riempimento

1
const gd.NOFILL = 2;

EDGED

Stile di disegno a settore, disegna un arco che collega il punto iniziale e il punto finale e una linea retta che collega l'origine

1
const gd.EDGED = 4;

HORIZONTAL

Direzione di mirroring, elaborazione di mirroring orizzontale

1
const gd.HORIZONTAL = 1;

VERTICAL

Direzione dello specchio, elaborazione dello specchio verticale

1
const gd.VERTICAL = 2;

BOTH

Direzione di mirroring, elaborazione di mirroring sia orizzontale che verticale

1
const gd.BOTH = 3;

LEFT

Direzione di rotazione, ruotare a sinistra

1
const gd.LEFT = 1;

Direzione di rotazione, ruotare a destra

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Tipo di filtro: utilizza il metodo di rimozione medio per ottenere l'effetto contorno

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Tipo di filtro: utilizza il rilevamento dei bordi per evidenziare i bordi dell'immagine

1
const gd.EDGEDETECT = 1;

EMBOSS

Tipo di filtro: immagine in rilievo

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Tipo di filtro: Immagine sfocata

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Tipo di filtro: Sfocatura immagine con algoritmo gaussiano

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Tipo di filtro: inverte tutti i colori nell'immagine

1
const gd.NEGATE = 5;

GRAYSCALE

Tipo di filtro: Converti immagine in scala di grigi

1
const gd.GRAYSCALE = 6;

SMOOTH

Tipo di filtro: rende l'immagine più fluida, utilizza arg1 per impostare il livello di morbidezza

1
const gd.SMOOTH = 7;

BRIGHTNESS

Tipo di filtro: modifica la luminosità dell'immagine, utilizza arg1 per impostare il livello di luminosità, l'intervallo di valori è -255~255

1
const gd.BRIGHTNESS = 8;

CONTRAST

Tipo di filtro: modifica il contrasto dell'immagine, utilizza arg1 per impostare il livello di contrasto, l'intervallo di valori è 0~100

1
const gd.CONTRAST = 9;

COLORIZE

Tipo di filtro: modifica la tonalità dell'immagine. Utilizza arg1, arg2 e arg3 per specificare rispettivamente rosso, blu e verde. L'intervallo di ciascun colore è 0~255. arg4 è la trasparenza e il valore restituito è 0~127.

1
const gd.COLORIZE = 10;