Базовый модуль модуля

модуль гд

Модуль gd — это модуль обработки изображений. Он предоставляет функции создания, работы и хранения изображений, а также обеспечивает множество операций с цветом, фильтрами, рисованием и другими сопутствующими операциями.

Вот пример кода, который использует модуль gd для создания изображения и управления им:

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

В этом примере мы сначала используем метод create() для создания изображения TRUECLOR размером 440x240 и используем метод colorAllocate() для назначения двух цветов, затем используем метод прямоугольник() для рисования прямоугольника и рисования заполненного эллипса, а затем наконец, используйте метод getData(), чтобы сохранить изображение как двоичные данные в формате PNG.

статическая функция

create

Создать новое изображение

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

Параметры звонка:

  • width: целое число, укажите ширину изображения.
  • height: целое число, укажите высоту изображения.
  • color: целое число, указывает тип изображения, допустимые значения:gd.TRUECOLORилиgd.PALETTE

Результаты возврата:

  • Image, возвращает успешно созданный объект изображения

load

Декодирование изображения из данных формата

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

Параметры звонка:

  • data:Buffer, учитывая декодированные данные изображения

Результаты возврата:

  • Image, возвращает успешно декодированный объект изображения

Декодировать изображение из объекта потока

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

Параметры звонка:

  • stm:SeekableStream, объект потока, в котором расположены данные изображения

Результаты возврата:

  • Image, возвращает успешно декодированный объект изображения

Декодировать изображение из указанного файла

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

Параметры звонка:

  • fname: Строка, укажите имя файла

Результаты возврата:

  • Image, возвращает успешно декодированный объект изображения

rgb

Генерация комбинированных цветов из цветовых компонентов RGB

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

Параметры звонка:

  • red: целое число, красная составляющая, диапазон 0–255.
  • green: целое число, зеленая составляющая, диапазон 0–255.
  • blue: целое число, синяя составляющая, диапазон 0–255.

Результаты возврата:

  • Integer, возвращает объединенный цвет

rgba

Генерация комбинированных цветов из цветовых компонентов rgba

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

Параметры звонка:

  • red: целое число, красная составляющая, диапазон 0–255.
  • green: целое число, зеленая составляющая, диапазон 0–255.
  • blue: целое число, синяя составляющая, диапазон 0–255.
  • alpha: Число, прозрачный компонент, диапазон 0,0–1,0.

Результаты возврата:

  • Integer, возвращает объединенный цвет

hsl

Генерация комбинированных цветов из цветовых компонентов hsl

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

Параметры звонка:

  • hue: Число, компонент оттенка, диапазон 0–360.
  • saturation: Число, компонент насыщения, диапазон: 0,0–1,0.
  • lightness: Число, компонент яркости, диапазон 0,0–1,0.

Результаты возврата:

  • Integer, возвращает объединенный цвет

hsla

Генерация комбинированных цветов из цветовых компонентов hsla

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

Параметры звонка:

  • hue: Число, компонент оттенка, диапазон 0–360.
  • saturation: Число, компонент насыщения, диапазон: 0,0–1,0.
  • lightness: Число, компонент яркости, диапазон 0,0–1,0.
  • alpha: Число, прозрачный компонент, диапазон 0,0–1,0.

Результаты возврата:

  • Integer, возвращает объединенный цвет

hsb

Генерация комбинированных цветов из цветовых компонентов hsb

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

Параметры звонка:

  • hue: Число, компонент оттенка, диапазон 0–360.
  • saturation: Число, компонент насыщения, диапазон: 0,0–1,0.
  • brightness: Число, компонент яркости, диапазон 0,0–1,0.

Результаты возврата:

  • Integer, возвращает объединенный цвет

hsba

Генерация комбинированных цветов из цветовых компонентов hsba

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

Параметры звонка:

  • hue: Число, компонент оттенка, диапазон 0–360.
  • saturation: Число, компонент насыщения, диапазон: 0,0–1,0.
  • brightness: Число, компонент яркости, диапазон 0,0–1,0.
  • alpha: Число, прозрачный компонент, диапазон 0,0–1,0.

Результаты возврата:

  • Integer, возвращает объединенный цвет

color

Генерировать комбинированные цвета из строки

1
static Integer gd.color(String color);

Параметры звонка:

  • color: строка, строка, определяющая цвет, например: «#ff0000», «ff0000», «#f00», «f00».

Результаты возврата:

  • Integer, возвращает объединенный цвет

постоянный

NONE

Константа формата изображения, указывающая, что текущий источник изображения неизвестен.

1
const gd.NONE = 0;

JPEG

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата JPEG.

1
const gd.JPEG = 1;

GIF

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата gif.

1
const gd.GIF = 2;

PNG

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата PNG.

1
const gd.PNG = 3;

TIFF

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата tiff.

1
const gd.TIFF = 4;

BMP

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата bmp.

1
const gd.BMP = 5;

WEBP

Константа формата изображения, указывающая, что текущий источник изображения представляет собой данные формата WebP.

1
const gd.WEBP = 6;

TRUECOLOR

Константа типа изображения, указывающая, что текущее изображение является полноцветным.

1
const gd.TRUECOLOR = 0;

PALETTE

Константа типа изображения, указывающая, что текущее изображение является изображением палитры.

1
const gd.PALETTE = 1;

ARC

Стиль рисования секторов: рисует дугу, соединяющую начальную и конечную точки.

1
const gd.ARC = 0;

CHORD

Стиль рисования секторов: нарисуйте прямую линию, соединяющую начальную, начальную и конечную точки.

1
const gd.CHORD = 1;

NOFILL

Стиль рисования секторов: рисует сектор без заливки.

1
const gd.NOFILL = 2;

EDGED

Стиль рисования секторов: нарисуйте дугу, соединяющую начальную точку и конечную точку, и прямую линию, соединяющую начало координат.

1
const gd.EDGED = 4;

HORIZONTAL

Направление зеркального отображения, обработка горизонтального зеркального отображения

1
const gd.HORIZONTAL = 1;

VERTICAL

Направление зеркала, обработка вертикального зеркала

1
const gd.VERTICAL = 2;

BOTH

Направление зеркального отображения, обработка как горизонтального, так и вертикального зеркального отображения.

1
const gd.BOTH = 3;

LEFT

Направление вращения: повернуть влево

1
const gd.LEFT = 1;

Направление вращения: повернуть вправо

1
const gd.RIGHT = 2;

MEAN_REMOVAL

Тип фильтра: используйте метод удаления среднего значения для достижения контурного эффекта.

1
const gd.MEAN_REMOVAL = 0;

EDGEDETECT

Тип фильтра: использовать обнаружение краев, чтобы выделить края изображения.

1
const gd.EDGEDETECT = 1;

EMBOSS

Тип фильтра: Тиснение изображения

1
const gd.EMBOSS = 2;

SELECTIVE_BLUR

Тип фильтра: Размытие изображения

1
const gd.SELECTIVE_BLUR = 3;

GAUSSIAN_BLUR

Тип фильтра: Размытие изображения с помощью алгоритма Гаусса.

1
const gd.GAUSSIAN_BLUR = 4;

NEGATE

Тип фильтра: Инвертировать все цвета изображения.

1
const gd.NEGATE = 5;

GRAYSCALE

Тип фильтра: Преобразование изображения в оттенки серого.

1
const gd.GRAYSCALE = 6;

SMOOTH

Тип фильтра: сделайте изображение более плавным, используйте arg1, чтобы установить уровень сглаживания.

1
const gd.SMOOTH = 7;

BRIGHTNESS

Тип фильтра: измените яркость изображения, используйте arg1, чтобы установить уровень яркости, диапазон значений: -255~255.

1
const gd.BRIGHTNESS = 8;

CONTRAST

Тип фильтра: измените контрастность изображения, используйте arg1, чтобы установить уровень контрастности, диапазон значений: 0–100.

1
const gd.CONTRAST = 9;

COLORIZE

Тип фильтра: изменение оттенка изображения. Используйте arg1, arg2 и arg3, чтобы указать красный, синий и зеленый соответственно. Диапазон каждого цвета – 0–255. arg4 – прозрачность, возвращаемое значение – 0–127.

1
const gd.COLORIZE = 10;