Modul Grundmodul
  1. Titelseite
  2. Basismodul
  3. Modul gd

Modul gd

Das GD-Modul ist ein Modul für die Bildverarbeitung. Es bietet Funktionen zum Erstellen, Bearbeiten und Speichern von Bildern sowie eine Fülle von Farb-, Filter-, Zeichen- und anderen zugehörigen Vorgängen.

Hier ist ein Beispielcode, der das gd-Modul zum Erstellen und Bearbeiten eines Bildes verwendet:

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 diesem Beispiel verwenden wir zunächst die Methode create(), um ein 440x240 TRUECOLOR-Bild zu erstellen, und verwenden die Methode colorAllocate(), um zwei Farben zuzuweisen. Anschließend verwenden wir die Methode context(), um ein Rechteck und eine gefüllte Ellipse zu zeichnen Verwenden Sie abschließend die Methode getData(), um das Bild als Binärdaten im PNG-Format zu speichern.

statische Funktion

create

Erstellen Sie ein neues Bild

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

Aufrufparameter:

  • width: Ganzzahl, geben Sie die Bildbreite an
  • height: Ganzzahl, geben Sie die Bildhöhe an
  • color: Ganzzahl, gibt den Bildtyp an, zulässige Werte sindgd.TRUECOLORodergd.PALETTE

Rückgabeergebnisse:

  • Image, gibt das erfolgreich erstellte Bildobjekt zurück

load

Bild aus Formatdaten dekodieren

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

Aufrufparameter:

  • data:Buffer, angesichts der dekodierten Bilddaten

Rückgabeergebnisse:

  • Image, gibt das erfolgreich dekodierte Bildobjekt zurück

Bild aus Stream-Objekt dekodieren

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

Aufrufparameter:

  • stm:SeekableStream, das Stream-Objekt, in dem sich die angegebenen Bilddaten befinden

Rückgabeergebnisse:

  • Image, gibt das erfolgreich dekodierte Bildobjekt zurück

Dekodieren Sie ein Bild aus der angegebenen Datei

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

Aufrufparameter:

  • fname: String, geben Sie den Dateinamen an

Rückgabeergebnisse:

  • Image, gibt das erfolgreich dekodierte Bildobjekt zurück

rgb

Erzeugen Sie kombinierte Farben aus RGB-Farbkomponenten

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

Aufrufparameter:

  • red: Ganzzahl, rote Komponente, Bereich 0-255
  • green: Ganzzahl, grüne Komponente, Bereich 0-255
  • blue: Ganzzahl, blaue Komponente, Bereich 0-255

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

rgba

Erzeugen Sie kombinierte Farben aus RGBA-Farbkomponenten

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

Aufrufparameter:

  • red: Ganzzahl, rote Komponente, Bereich 0-255
  • green: Ganzzahl, grüne Komponente, Bereich 0-255
  • blue: Ganzzahl, blaue Komponente, Bereich 0-255
  • alpha: Zahl, transparente Komponente, Bereich ist 0,0-1,0

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

hsl

Erzeugen Sie kombinierte Farben aus HSL-Farbkomponenten

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

Aufrufparameter:

  • hue: Zahl, Farbtonkomponente, Bereich ist 0-360
  • saturation: Zahl, Sättigungskomponente, Bereich ist 0,0-1,0
  • lightness: Zahl, Helligkeitskomponente, Bereich ist 0,0-1,0

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

hsla

Generieren Sie kombinierte Farben aus HSLA-Farbkomponenten

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

Aufrufparameter:

  • hue: Zahl, Farbtonkomponente, Bereich ist 0-360
  • saturation: Zahl, Sättigungskomponente, Bereich ist 0,0-1,0
  • lightness: Zahl, Helligkeitskomponente, Bereich ist 0,0-1,0
  • alpha: Zahl, transparente Komponente, Bereich ist 0,0-1,0

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

hsb

Erzeugen Sie kombinierte Farben aus HSB-Farbkomponenten

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

Aufrufparameter:

  • hue: Zahl, Farbtonkomponente, Bereich ist 0-360
  • saturation: Zahl, Sättigungskomponente, Bereich ist 0,0-1,0
  • brightness: Zahl, Helligkeitskomponente, Bereich ist 0,0-1,0

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

hsba

Generieren Sie kombinierte Farben aus HSBA-Farbkomponenten

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

Aufrufparameter:

  • hue: Zahl, Farbtonkomponente, Bereich ist 0-360
  • saturation: Zahl, Sättigungskomponente, Bereich ist 0,0-1,0
  • brightness: Zahl, Helligkeitskomponente, Bereich ist 0,0-1,0
  • alpha: Zahl, transparente Komponente, Bereich ist 0,0-1,0

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

color

Erzeugen Sie kombinierte Farben aus einer Zeichenfolge

1
static Integer gd.color(String color);

Aufrufparameter:

  • color: String, ein String, der die Farbe angibt, wie zum Beispiel: „#ff0000“, „ff0000“, „#f00“, „f00“

Rückgabeergebnisse:

  • Integer, gibt die kombinierte Farbe zurück

Konstante

NONE

Bildformatkonstante, die angibt, dass die aktuelle Bildquelle unbekannt ist

1
const gd.NONE = 0;

JPEG

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im JPEG-Format handelt

1
const gd.JPEG = 1;

GIF

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im GIF-Format handelt

1
const gd.GIF = 2;

PNG

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im PNG-Format handelt

1
const gd.PNG = 3;

TIFF

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im TIFF-Format handelt

1
const gd.TIFF = 4;

BMP

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im BMP-Format handelt

1
const gd.BMP = 5;

WEBP

Bildformatkonstante, die angibt, dass es sich bei der aktuellen Bildquelle um Daten im WebP-Format handelt

1
const gd.WEBP = 6;

TRUECOLOR

Bildtypkonstante, die angibt, dass das aktuelle Bild ein Echtfarbenbild ist

1
const gd.TRUECOLOR = 0;

PALETTE

Bildtypkonstante, die angibt, dass das aktuelle Bild ein Palettenbild ist

1
const gd.PALETTE = 1;

ARC

Der Sektorzeichnungsstil zeichnet einen Bogen, der die Start- und Endpunkte verbindet

1
const gd.ARC = 0;

CHORD

Zeichnen Sie im Sektorzeichnungsstil eine gerade Linie, die den Ursprungs-, Start- und Endpunkt verbindet

1
const gd.CHORD = 1;

NOFILL

Sektorzeichnungsstil, zeichnet einen Sektor ohne Füllung

1
const gd.NOFILL = 2;

EDGED

Zeichnen Sie im Sektorzeichnungsstil einen Bogen, der den Startpunkt und den Endpunkt verbindet, und eine gerade Linie, die den Ursprung verbindet

1
const gd.EDGED = 4;

HORIZONTAL

Spiegelrichtung, horizontale Spiegelverarbeitung

1
const gd.HORIZONTAL = 1;

VERTICAL

Spiegelrichtung, vertikale Spiegelverarbeitung

1
const gd.VERTICAL = 2;

BOTH

Spiegelungsrichtung, sowohl horizontale als auch vertikale Spiegelungsverarbeitung

1
const gd.BOTH = 3;

LEFT

Drehrichtung, nach links drehen

1
const gd.LEFT = 1;

Drehrichtung, rechts drehen

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Filtertyp: Verwenden Sie die durchschnittliche Entfernungsmethode, um einen Kontureffekt zu erzielen

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Filtertyp: Verwenden Sie die Kantenerkennung, um die Kanten des Bildes hervorzuheben

1
const gd.EDGEDETECT = 1;

EMBOSS

Filtertyp: Bild prägen

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Filtertyp: Bild verwischen

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Filtertyp: Bild mit Gauß-Algorithmus verwischen

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Filtertyp: Alle Farben im Bild umkehren

1
const gd.NEGATE = 5;

GRAYSCALE

Filtertyp: Bild in Graustufen konvertieren

1
const gd.GRAYSCALE = 6;

SMOOTH

Filtertyp: Machen Sie das Bild glatter. Verwenden Sie arg1, um den Glättungsgrad festzulegen

1
const gd.SMOOTH = 7;

BRIGHTNESS

Filtertyp: Ändern Sie die Helligkeit des Bildes. Verwenden Sie arg1, um die Helligkeitsstufe festzulegen. Der Wertebereich liegt zwischen -255 und 255

1
const gd.BRIGHTNESS = 8;

CONTRAST

Filtertyp: Ändern Sie den Kontrast des Bildes. Verwenden Sie arg1, um die Kontraststufe festzulegen. Der Wertebereich liegt zwischen 0 und 100

1
const gd.CONTRAST = 9;

COLORIZE

Filtertyp: Ändern Sie den Farbton des Bildes. Verwenden Sie arg1, arg2 und arg3, um Rot, Blau bzw. Grün anzugeben. Der Bereich jeder Farbe liegt zwischen 0 und 255. arg4 ist Transparenz und der zurückgegebene Wert ist 0 bis 127.

1
const gd.COLORIZE = 10;
© Copyright 2012-2024 fibjs.org | Unterstützen Sie uns