モジュール gd

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() メソッドを使用して 440x240 の TRUECOLOR 画像を作成し、colorAllocate() メソッドを使用して 2 つの色を割り当てます。次に、rectangle() メソッドを使用して四角形を描画し、塗りつぶされたものを上に描画します。長方形 Ellipse の右上、最後に 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;

RIGHT

回転方向、右回転

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;

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティ モジュール

モジュール gd

静的関数

create

load

rgb

rgba

hsl

hsla

hsb

hsba

color

絶え間ない

NONE

JPEG

GIF

PNG

TIFF

BMP

WEBP

TRUECOLOR

PALETTE

ARC

CHORD

NOFILL

EDGED

HORIZONTAL

VERTICAL

BOTH

LEFT

RIGHT

MEAN_REMOVAL

EDGEDETECT

EMBOSS

SELECTIVE_BLUR

GAUSSIAN_BLUR

NEGATE

GRAYSCALE

SMOOTH

BRIGHTNESS

CONTRAST

COLORIZE

コミュニティモジュール