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
10var 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
3static 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
1static 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
1static 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
1static 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
3static 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
4static 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
3static 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
4static 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
3static 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
4static 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
1static 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
1const gd.NONE = 0;
JPEG
Costante del formato immagine, che indica che l'origine dell'immagine corrente sono dati in formato jpeg
1const gd.JPEG = 1;
GIF
Costante del formato immagine, che indica che la sorgente dell'immagine corrente è costituita da dati in formato gif
1const gd.GIF = 2;
PNG
Costante del formato immagine, che indica che l'origine dell'immagine corrente è costituita da dati in formato PNG
1const gd.PNG = 3;
TIFF
Costante del formato immagine, che indica che l'origine dell'immagine corrente è costituita da dati in formato tiff
1const gd.TIFF = 4;
BMP
Costante del formato immagine, che indica che la sorgente dell'immagine corrente sono dati in formato bmp
1const gd.BMP = 5;
WEBP
Costante del formato immagine, che indica che l'origine dell'immagine corrente sono dati in formato webp
1const gd.WEBP = 6;
TRUECOLOR
Costante del tipo di immagine, che indica che l'immagine corrente è un'immagine a colori reali
1const gd.TRUECOLOR = 0;
PALETTE
Costante del tipo di immagine, che indica che l'immagine corrente è un'immagine della tavolozza
1const gd.PALETTE = 1;
ARC
Stile di disegno a settore: disegna un arco che collega i punti iniziale e finale
1const gd.ARC = 0;
CHORD
Stile di disegno del settore, traccia una linea retta che collega i punti di origine, inizio e fine
1const gd.CHORD = 1;
NOFILL
Stile di disegno del settore, disegna un settore senza riempimento
1const 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
1const gd.EDGED = 4;
HORIZONTAL
Direzione di mirroring, elaborazione di mirroring orizzontale
1const gd.HORIZONTAL = 1;
VERTICAL
Direzione dello specchio, elaborazione dello specchio verticale
1const gd.VERTICAL = 2;
BOTH
Direzione di mirroring, elaborazione di mirroring sia orizzontale che verticale
1const gd.BOTH = 3;
LEFT
Direzione di rotazione, ruotare a sinistra
1const gd.LEFT = 1;
RIGHT
Direzione di rotazione, ruotare a destra
1const gd.RIGHT = 2;
MEAN_REMOVAL
Tipo di filtro: utilizza il metodo di rimozione medio per ottenere l'effetto contorno
1const gd.MEAN_REMOVAL = 0;
EDGEDETECT
Tipo di filtro: utilizza il rilevamento dei bordi per evidenziare i bordi dell'immagine
1const gd.EDGEDETECT = 1;
EMBOSS
Tipo di filtro: immagine in rilievo
1const gd.EMBOSS = 2;
SELECTIVE_BLUR
Tipo di filtro: Immagine sfocata
1const gd.SELECTIVE_BLUR = 3;
GAUSSIAN_BLUR
Tipo di filtro: Sfocatura immagine con algoritmo gaussiano
1const gd.GAUSSIAN_BLUR = 4;
NEGATE
Tipo di filtro: inverte tutti i colori nell'immagine
1const gd.NEGATE = 5;
GRAYSCALE
Tipo di filtro: Converti immagine in scala di grigi
1const gd.GRAYSCALE = 6;
SMOOTH
Tipo di filtro: rende l'immagine più fluida, utilizza arg1 per impostare il livello di morbidezza
1const 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
1const 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
1const 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.
1const gd.COLORIZE = 10;