fibjs / Modules / gd

gd

图像文件处理模块

基础模块。可用于创建和操作图像文件，引用方式：

var gd = require('gd');

Field Summary

Type	Method and Description
const	`public const NONENONENONE` 图像格式常量，标示当前图像来源为未知
const	`public const JPEGJPEGJPEG` 图像格式常量，标示当前图像来源为 jpeg 格式数据
const	`public const GIFGIFGIF` 图像格式常量，标示当前图像来源为 gif 格式数据
const	`public const PNGPNGPNG` 图像格式常量，标示当前图像来源为 png 格式数据
const	`public const TIFFTIFFTIFF` 图像格式常量，标示当前图像来源为 tiff 格式数据
const	`public const BMPBMPBMP` 图像格式常量，标示当前图像来源为 bmp 格式数据
const	`public const WEBPWEBPWEBP` 图像格式常量，标示当前图像来源为 webp 格式数据
const	`public const TRUECOLORTRUECOLORTRUECOLOR` 图像类型常量，标示当前图像为真彩色图像
const	`public const PALETTEPALETTEPALETTE` 图像类型常量，标示当前图像为调色板图像
const	`public const ARCARCARC` 扇形绘制样式，绘制一条连接开始和结束点的圆弧
const	`public const CHORDCHORDCHORD` 扇形绘制样式，绘制一条连接原点，开始和结束点的直线
const	`public const NOFILLNOFILLNOFILL` 扇形绘制样式，绘制不填充的扇形
const	`public const EDGEDEDGEDEDGED` 扇形绘制样式，绘制一条连接起点和终点的弧和连接原点的直线
const	`public const HORIZONTALHORIZONTALHORIZONTAL` 镜像方向，横向做镜像处理
const	`public const VERTICALVERTICALVERTICAL` 镜像方向，纵向做镜像处理
const	`public const BOTHBOTHBOTH` 镜像方向，横向和纵向都做镜像处理
const	`public const LEFTLEFTLEFT` 旋转方向，向左旋转
const	`public const RIGHTRIGHTRIGHT` 旋转方向，向右旋转
const	`public const MEAN_REMOVALMEAN_REMOVALMEAN_REMOVAL` 滤波器类型：用平均移除法来达到轮廓效果
const	`public const EDGEDETECTEDGEDETECTEDGEDETECT` 滤波器类型：用边缘检测来突出图像的边缘
const	`public const EMBOSSEMBOSSEMBOSS` 滤波器类型：使图像浮雕化
const	`public const SELECTIVE_BLURSELECTIVE_BLURSELECTIVE_BLUR` 滤波器类型：模糊图像
const	`public const GAUSSIAN_BLURGAUSSIAN_BLURGAUSSIAN_BLUR` 滤波器类型：用高斯算法模糊图像
const	`public const NEGATENEGATENEGATE` 滤波器类型：将图像中所有颜色反转
const	`public const GRAYSCALEGRAYSCALEGRAYSCALE` 滤波器类型：将图像转换为灰度图
const	`public const SMOOTHSMOOTHSMOOTH` 滤波器类型：使图像更柔滑，用arg1设定柔滑级别
const	`public const BRIGHTNESSBRIGHTNESSBRIGHTNESS` 滤波器类型：改变图像的亮度，用arg1设定亮度级别，取值范围是-255~255
const	`public const CONTRASTCONTRASTCONTRAST` 滤波器类型：改变图像的对比度，用arg1设定对比度级别，取值范围是0~100
const	`public const COLORIZECOLORIZECOLORIZE` 滤波器类型：改变图像的色调，用arg1、arg2、arg3分别指定red、blue、green，每种颜色范围是0~255，arg4为透明度，取值返回是0~127

Method Summary

Type	Method and Description
Image	`create(Integer width,Integer height,Integer color)` 创建一个新图像
Image	`load(Buffer data)` 从格式数据中解码图像
Image	`load(SeekableStream stm)` 从流对象中解码图像
Image	`load(String fname)` 从指定文件中解码图像
Integer	`rgb(Integer red,Integer green,Integer blue)` 通过 rgb 颜色分量生成组合颜色
Integer	`rgba(Integer red,Integer green,Integer blue,Number alpha)` 通过 rgba 颜色分量生成组合颜色
Integer	`hsl(Number hue,Number saturation,Number lightness)` 通过 hsl 颜色分量生成组合颜色
Integer	`hsla(Number hue,Number saturation,Number lightness,Number alpha)` 通过 hsla 颜色分量生成组合颜色
Integer	`hsb(Number hue,Number saturation,Number brightness)` 通过 hsb 颜色分量生成组合颜色
Integer	`hsba(Number hue,Number saturation,Number brightness,Number alpha)` 通过 hsba 颜色分量生成组合颜色
Integer	`color(String color)` 通过字符串生成组合颜色

Field Detail

NONE

const `public const NONENONENONE`

图像格式常量，标示当前图像来源为未知

JPEG

const `public const JPEGJPEGJPEG`

图像格式常量，标示当前图像来源为 jpeg 格式数据

GIF

const `public const GIFGIFGIF`

图像格式常量，标示当前图像来源为 gif 格式数据

PNG

const `public const PNGPNGPNG`

图像格式常量，标示当前图像来源为 png 格式数据

TIFF

const `public const TIFFTIFFTIFF`

图像格式常量，标示当前图像来源为 tiff 格式数据

BMP

const `public const BMPBMPBMP`

图像格式常量，标示当前图像来源为 bmp 格式数据

WEBP

const `public const WEBPWEBPWEBP`

图像格式常量，标示当前图像来源为 webp 格式数据

TRUECOLOR

const `public const TRUECOLORTRUECOLORTRUECOLOR`

图像类型常量，标示当前图像为真彩色图像

PALETTE

const `public const PALETTEPALETTEPALETTE`

图像类型常量，标示当前图像为调色板图像

ARC

const `public const ARCARCARC`

扇形绘制样式，绘制一条连接开始和结束点的圆弧

CHORD

const `public const CHORDCHORDCHORD`

扇形绘制样式，绘制一条连接原点，开始和结束点的直线

NOFILL

const `public const NOFILLNOFILLNOFILL`

扇形绘制样式，绘制不填充的扇形

EDGED

const `public const EDGEDEDGEDEDGED`

扇形绘制样式，绘制一条连接起点和终点的弧和连接原点的直线

HORIZONTAL

const `public const HORIZONTALHORIZONTALHORIZONTAL`

镜像方向，横向做镜像处理

VERTICAL

const `public const VERTICALVERTICALVERTICAL`

镜像方向，纵向做镜像处理

BOTH

const `public const BOTHBOTHBOTH`

镜像方向，横向和纵向都做镜像处理

LEFT

const `public const LEFTLEFTLEFT`

旋转方向，向左旋转

RIGHT

const `public const RIGHTRIGHTRIGHT`

旋转方向，向右旋转

MEAN_REMOVAL

const `public const MEAN_REMOVALMEAN_REMOVALMEAN_REMOVAL`

滤波器类型：用平均移除法来达到轮廓效果

EDGEDETECT

const `public const EDGEDETECTEDGEDETECTEDGEDETECT`

滤波器类型：用边缘检测来突出图像的边缘

EMBOSS

const `public const EMBOSSEMBOSSEMBOSS`

滤波器类型：使图像浮雕化

SELECTIVE_BLUR

const `public const SELECTIVE_BLURSELECTIVE_BLURSELECTIVE_BLUR`

滤波器类型：模糊图像

GAUSSIAN_BLUR

const `public const GAUSSIAN_BLURGAUSSIAN_BLURGAUSSIAN_BLUR`

滤波器类型：用高斯算法模糊图像

NEGATE

const `public const NEGATENEGATENEGATE`

滤波器类型：将图像中所有颜色反转

GRAYSCALE

const `public const GRAYSCALEGRAYSCALEGRAYSCALE`

滤波器类型：将图像转换为灰度图

SMOOTH

const `public const SMOOTHSMOOTHSMOOTH`

滤波器类型：使图像更柔滑，用arg1设定柔滑级别

BRIGHTNESS

const `public const BRIGHTNESSBRIGHTNESSBRIGHTNESS`

滤波器类型：改变图像的亮度，用arg1设定亮度级别，取值范围是-255~255

CONTRAST

const `public const CONTRASTCONTRASTCONTRAST`

滤波器类型：改变图像的对比度，用arg1设定对比度级别，取值范围是0~100

COLORIZE

const `public const COLORIZECOLORIZECOLORIZE`

滤波器类型：改变图像的色调，用arg1、arg2、arg3分别指定red、blue、green，每种颜色范围是0~255，arg4为透明度，取值返回是0~127

Method Detail

create

Image `create(Integer width,Integer height,Integer color)`

创建一个新图像

Parameters

width 指定图像宽度
height 指定图像高度
color 指定图像类型，允许值为 gd.TRUECOLOR 或 gd.PALETTE

Returns

返回创建成功的图像对象

load

Image `load(Buffer data)`

从格式数据中解码图像

Parameters

data 给定解码的图像数据

Returns

返回解码成功的图像对象

load

Image `load(SeekableStream stm)`

从流对象中解码图像

Parameters

stm 给定图像数据所在的流对象

Returns

返回解码成功的图像对象

load

Image `load(String fname)`

从指定文件中解码图像

Parameters

fname 指定文件名

Returns

返回解码成功的图像对象

rgb

Integer `rgb(Integer red,Integer green,Integer blue)`

通过 rgb 颜色分量生成组合颜色

Parameters

red 红色分量，范围为 0-255
green 绿色分量，范围为 0-255
blue 蓝色分量，范围为 0-255

Returns

返回组合颜色

rgba

Integer `rgba(Integer red,Integer green,Integer blue,Number alpha)`

通过 rgba 颜色分量生成组合颜色

Parameters

red 红色分量，范围为 0-255
green 绿色分量，范围为 0-255
blue 蓝色分量，范围为 0-255
alpha 透明分量，范围为 0.0-1.0

Returns

返回组合颜色

hsl

Integer `hsl(Number hue,Number saturation,Number lightness)`

通过 hsl 颜色分量生成组合颜色

Parameters

hue 色相分量，范围为 0-360
saturation 饱和度分量，范围为 0.0-1.0
lightness 亮度分量，范围为 0.0-1.0

Returns

返回组合颜色

hsla

Integer `hsla(Number hue,Number saturation,Number lightness,Number alpha)`

通过 hsla 颜色分量生成组合颜色

Parameters

hue 色相分量，范围为 0-360
saturation 饱和度分量，范围为 0.0-1.0
lightness 亮度分量，范围为 0.0-1.0
alpha 透明分量，范围为 0.0-1.0

Returns

返回组合颜色

hsb

Integer `hsb(Number hue,Number saturation,Number brightness)`

通过 hsb 颜色分量生成组合颜色

Parameters

hue 色相分量，范围为 0-360
saturation 饱和度分量，范围为 0.0-1.0
brightness 明亮程度分量，范围为 0.0-1.0

Returns

返回组合颜色

hsba

Integer `hsba(Number hue,Number saturation,Number brightness,Number alpha)`

通过 hsba 颜色分量生成组合颜色

Parameters

hue 色相分量，范围为 0-360
saturation 饱和度分量，范围为 0.0-1.0
brightness 明亮程度分量，范围为 0.0-1.0
alpha 透明分量，范围为 0.0-1.0

Returns

返回组合颜色

color

Integer `color(String color)`

通过字符串生成组合颜色

Parameters

color 指定颜色的字符串，如：”#ff0000”, “ff0000”, “#f00”, “f00”

Returns

返回组合颜色

gd

Field Summary

Method Summary

Field Detail

const public const NONENONENONE

const public const JPEGJPEGJPEG

const public const GIFGIFGIF

const public const PNGPNGPNG

const public const TIFFTIFFTIFF

const public const BMPBMPBMP

const public const WEBPWEBPWEBP

const public const TRUECOLORTRUECOLORTRUECOLOR

const public const PALETTEPALETTEPALETTE

const public const ARCARCARC

const public const CHORDCHORDCHORD

const public const NOFILLNOFILLNOFILL

const public const EDGEDEDGEDEDGED

const public const HORIZONTALHORIZONTALHORIZONTAL

const public const VERTICALVERTICALVERTICAL

const public const BOTHBOTHBOTH

const public const LEFTLEFTLEFT

const public const RIGHTRIGHTRIGHT

const public const MEAN_REMOVALMEAN_REMOVALMEAN_REMOVAL

const public const EDGEDETECTEDGEDETECTEDGEDETECT

const public const EMBOSSEMBOSSEMBOSS

const public const SELECTIVE_BLURSELECTIVE_BLURSELECTIVE_BLUR

const public const GAUSSIAN_BLURGAUSSIAN_BLURGAUSSIAN_BLUR

const public const NEGATENEGATENEGATE

const public const GRAYSCALEGRAYSCALEGRAYSCALE

const public const SMOOTHSMOOTHSMOOTH

const public const BRIGHTNESSBRIGHTNESSBRIGHTNESS

const public const CONTRASTCONTRASTCONTRAST

const public const COLORIZECOLORIZECOLORIZE

Method Detail

Image create(Integer width,Integer height,Integer color)

Parameters

Returns

Image load(Buffer data)

Parameters

Returns

Image load(SeekableStream stm)

Parameters

Returns

Image load(String fname)

Parameters

Returns

Integer rgb(Integer red,Integer green,Integer blue)

Parameters

Returns

Integer rgba(Integer red,Integer green,Integer blue,Number alpha)

Parameters

Returns

Integer hsl(Number hue,Number saturation,Number lightness)

Parameters

Returns

Integer hsla(Number hue,Number saturation,Number lightness,Number alpha)

Parameters

Returns

Integer hsb(Number hue,Number saturation,Number brightness)

Parameters

Returns

Integer hsba(Number hue,Number saturation,Number brightness,Number alpha)

Parameters

Returns

Integer color(String color)

Parameters

Returns

const `public const NONENONENONE`

const `public const JPEGJPEGJPEG`

const `public const GIFGIFGIF`

const `public const PNGPNGPNG`

const `public const TIFFTIFFTIFF`

const `public const BMPBMPBMP`

const `public const WEBPWEBPWEBP`

const `public const TRUECOLORTRUECOLORTRUECOLOR`

const `public const PALETTEPALETTEPALETTE`

const `public const ARCARCARC`

const `public const CHORDCHORDCHORD`

const `public const NOFILLNOFILLNOFILL`

const `public const EDGEDEDGEDEDGED`

const `public const HORIZONTALHORIZONTALHORIZONTAL`

const `public const VERTICALVERTICALVERTICAL`

const `public const BOTHBOTHBOTH`

const `public const LEFTLEFTLEFT`

const `public const RIGHTRIGHTRIGHT`

const `public const MEAN_REMOVALMEAN_REMOVALMEAN_REMOVAL`

const `public const EDGEDETECTEDGEDETECTEDGEDETECT`

const `public const EMBOSSEMBOSSEMBOSS`

const `public const SELECTIVE_BLURSELECTIVE_BLURSELECTIVE_BLUR`

const `public const GAUSSIAN_BLURGAUSSIAN_BLURGAUSSIAN_BLUR`

const `public const NEGATENEGATENEGATE`

const `public const GRAYSCALEGRAYSCALEGRAYSCALE`

const `public const SMOOTHSMOOTHSMOOTH`

const `public const BRIGHTNESSBRIGHTNESSBRIGHTNESS`

const `public const CONTRASTCONTRASTCONTRAST`

const `public const COLORIZECOLORIZECOLORIZE`

Image `create(Integer width,Integer height,Integer color)`

Image `load(Buffer data)`

Image `load(SeekableStream stm)`

Image `load(String fname)`

Integer `rgb(Integer red,Integer green,Integer blue)`

Integer `rgba(Integer red,Integer green,Integer blue,Number alpha)`

Integer `hsl(Number hue,Number saturation,Number lightness)`

Integer `hsla(Number hue,Number saturation,Number lightness,Number alpha)`

Integer `hsb(Number hue,Number saturation,Number brightness)`

Integer `hsba(Number hue,Number saturation,Number brightness,Number alpha)`

Integer `color(String color)`