module gd
De gd-module is een module voor beeldverwerking en biedt de functies voor het maken, bedienen en opslaan van afbeeldingen, en biedt een schat aan kleur-, filter-, teken- en andere gerelateerde bewerkingen.
Hier is een voorbeeldcode die de gd-module gebruikt om een afbeelding te maken en te manipuleren:
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 dit voorbeeld gebruiken we eerst de methode create() om een TRUECOLOR-afbeelding van 440 x 240 te maken, en gebruiken we de methode colorAllocate() om twee kleuren toe te wijzen. Vervolgens gebruiken we de methode rechthoek() om een rechthoek te tekenen en een gevulde ellips, en Gebruik ten slotte de methode getData() om de afbeelding op te slaan als binaire gegevens in PNG-indeling.
statische functie
create
Maak een nieuwe afbeelding
1
2
3static Image gd.create(Integer width,
Integer height,
Integer color = gd.TRUECOLOR) async;
Oproepparameters:
- width: geheel getal, geef de afbeeldingsbreedte op
- height: geheel getal, geef de afbeeldingshoogte op
- color: Geheel getal, specificeert het afbeeldingstype, toegestane waarden zijngd.TRUECOLORofgd.PALETTE
Resultaten retourneren:
- Image, retourneert het succesvol gemaakte afbeeldingsobject
load
Decodeer afbeelding uit formaatgegevens
1static Image gd.load(Buffer data) async;
Oproepparameters:
- data:Buffer, gegeven de gedecodeerde beeldgegevens
Resultaten retourneren:
- Image, retourneert het succesvol gedecodeerde afbeeldingsobject
Decodeer afbeelding uit streamobject
1static Image gd.load(SeekableStream stm) async;
Oproepparameters:
- stm:SeekableStream, het streamobject waar de gegeven afbeeldingsgegevens zich bevinden
Resultaten retourneren:
- Image, retourneert het succesvol gedecodeerde afbeeldingsobject
Decodeer een afbeelding uit het opgegeven bestand
1static Image gd.load(String fname) async;
Oproepparameters:
- fname: String, geef de bestandsnaam op
Resultaten retourneren:
- Image, retourneert het succesvol gedecodeerde afbeeldingsobject
rgb
Genereer gecombineerde kleuren uit RGB-kleurcomponenten
1
2
3static Integer gd.rgb(Integer red,
Integer green,
Integer blue);
Oproepparameters:
- red: geheel getal, rode component, bereik is 0-255
- green: geheel getal, groene component, bereik is 0-255
- blue: geheel getal, blauwe component, bereik is 0-255
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
rgba
Genereer gecombineerde kleuren uit RGB-kleurcomponenten
1
2
3
4static Integer gd.rgba(Integer red,
Integer green,
Integer blue,
Number alpha);
Oproepparameters:
- red: geheel getal, rode component, bereik is 0-255
- green: geheel getal, groene component, bereik is 0-255
- blue: geheel getal, blauwe component, bereik is 0-255
- alpha: Getal, transparante component, bereik is 0,0-1,0
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
hsl
Genereer gecombineerde kleuren uit hsl-kleurcomponenten
1
2
3static Integer gd.hsl(Number hue,
Number saturation,
Number lightness);
Oproepparameters:
- hue: Getal, tintcomponent, bereik is 0-360
- saturation: Getal, verzadigingscomponent, bereik is 0,0-1,0
- lightness: Getal, helderheidscomponent, bereik is 0,0-1,0
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
hsla
Genereer gecombineerde kleuren uit hsla-kleurcomponenten
1
2
3
4static Integer gd.hsla(Number hue,
Number saturation,
Number lightness,
Number alpha);
Oproepparameters:
- hue: Getal, tintcomponent, bereik is 0-360
- saturation: Getal, verzadigingscomponent, bereik is 0,0-1,0
- lightness: Getal, helderheidscomponent, bereik is 0,0-1,0
- alpha: Getal, transparante component, bereik is 0,0-1,0
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
hsb
Genereer gecombineerde kleuren uit hsb-kleurcomponenten
1
2
3static Integer gd.hsb(Number hue,
Number saturation,
Number brightness);
Oproepparameters:
- hue: Getal, tintcomponent, bereik is 0-360
- saturation: Getal, verzadigingscomponent, bereik is 0,0-1,0
- brightness: Getal, helderheidscomponent, bereik is 0,0-1,0
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
hsba
Genereer gecombineerde kleuren uit hsba-kleurcomponenten
1
2
3
4static Integer gd.hsba(Number hue,
Number saturation,
Number brightness,
Number alpha);
Oproepparameters:
- hue: Getal, tintcomponent, bereik is 0-360
- saturation: Getal, verzadigingscomponent, bereik is 0,0-1,0
- brightness: Getal, helderheidscomponent, bereik is 0,0-1,0
- alpha: Getal, transparante component, bereik is 0,0-1,0
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
color
Genereer gecombineerde kleuren uit tekenreeksen
1static Integer gd.color(String color);
Oproepparameters:
- color: String, een string die de kleur specificeert, zoals: "#ff0000", "ff0000", "#f00", "f00"
Resultaten retourneren:
- Integer, retourneert de gecombineerde kleur
constante
NONE
Beeldformaatconstante, wat aangeeft dat de huidige beeldbron onbekend is
1const gd.NONE = 0;
JPEG
Beeldformaatconstante, die aangeeft dat de huidige beeldbron gegevens in jpeg-formaat is
1const gd.JPEG = 1;
GIF
Constante afbeeldingsindeling, die aangeeft dat de huidige afbeeldingsbron gegevens in GIF-indeling is
1const gd.GIF = 2;
PNG
Beeldformaatconstante, wat aangeeft dat de huidige afbeeldingsbron png-formaatgegevens is
1const gd.PNG = 3;
TIFF
Beeldformaatconstante, die aangeeft dat de huidige beeldbron tiff-formaatgegevens is
1const gd.TIFF = 4;
BMP
Beeldformaatconstante, die aangeeft dat de huidige beeldbron gegevens in bmp-formaat is
1const gd.BMP = 5;
WEBP
Beeldformaatconstante, die aangeeft dat de huidige afbeeldingsbron webp-formaatgegevens is
1const gd.WEBP = 6;
TRUECOLOR
Beeldtypeconstante, die aangeeft dat de huidige afbeelding een afbeelding met echte kleuren is
1const gd.TRUECOLOR = 0;
PALETTE
Beeldtypeconstante, die aangeeft dat de huidige afbeelding een paletafbeelding is
1const gd.PALETTE = 1;
ARC
Sectortekenstijl, tekent een boog die de begin- en eindpunten verbindt
1const gd.ARC = 0;
CHORD
Sectortekenstijl: teken een rechte lijn die de oorsprong, het begin- en eindpunt verbindt
1const gd.CHORD = 1;
NOFILL
Sectortekenstijl, tekent een sector zonder vulling
1const gd.NOFILL = 2;
EDGED
In de sectortekenstijl tekent u een boog die het startpunt en het eindpunt verbindt, en een rechte lijn die de oorsprong verbindt
1const gd.EDGED = 4;
HORIZONTAL
Spiegelrichting, horizontale spiegelverwerking
1const gd.HORIZONTAL = 1;
VERTICAL
Spiegelrichting, verticale spiegelverwerking
1const gd.VERTICAL = 2;
BOTH
Spiegelrichting, zowel horizontale als verticale spiegelverwerking
1const gd.BOTH = 3;
LEFT
Draairichting, linksom draaien
1const gd.LEFT = 1;
RIGHT
Draairichting, draai naar rechts
1const gd.RIGHT = 2;
MEAN_REMOVAL
Filtertype: Gebruik de gemiddelde verwijderingsmethode om een contoureffect te bereiken
1const gd.MEAN_REMOVAL = 0;
EDGEDETECT
Filtertype: gebruik randdetectie om de randen van de afbeelding te markeren
1const gd.EDGEDETECT = 1;
EMBOSS
Filtertype: Afbeelding in reliëf maken
1const gd.EMBOSS = 2;
SELECTIVE_BLUR
Filtertype: Afbeelding vervagen
1const gd.SELECTIVE_BLUR = 3;
GAUSSIAN_BLUR
Filtertype: Afbeelding vervagen met Gauss-algoritme
1const gd.GAUSSIAN_BLUR = 4;
NEGATE
Filtertype: keer alle kleuren in de afbeelding om
1const gd.NEGATE = 5;
GRAYSCALE
Filtertype: Converteer afbeelding naar grijswaarden
1const gd.GRAYSCALE = 6;
SMOOTH
Filtertype: Maak de afbeelding vloeiender, gebruik arg1 om het vloeiendheidsniveau in te stellen
1const gd.SMOOTH = 7;
BRIGHTNESS
Filtertype: Verander de helderheid van de afbeelding, gebruik arg1 om het helderheidsniveau in te stellen, het waardebereik is -255~255
1const gd.BRIGHTNESS = 8;
CONTRAST
Filtertype: Verander het contrast van de afbeelding, gebruik arg1 om het contrastniveau in te stellen, het waardebereik is 0~100
1const gd.CONTRAST = 9;
COLORIZE
Filtertype: Wijzig de tint van de afbeelding. Gebruik arg1, arg2 en arg3 om respectievelijk rood, blauw en groen op te geven. Het bereik van elke kleur is 0~255. arg4 is transparantie en de geretourneerde waarde is 0~127.
1const gd.COLORIZE = 10;