Image 模块

Image 模块为 XScript 提供图像处理功能,支持图片读取、缩放、裁剪、格式转换等操作。

功能特性

图片读取 - 读取 JPEG、PNG、GIF、WebP 等格式

尺寸调整 - 缩放、裁剪、旋转图片

格式转换 - 图片格式相互转换

滤镜效果 - 模糊、锐化、灰度等

图片合成 - 多图合成、水印添加

元数据 - 读取和修改 EXIF 信息

批量处理 - 批量处理图片

基本使用

引入模块

读取图片

缩放图片

裁剪图片

格式转换

旋转和翻转

滤镜效果

添加水印

文字水印

API 参考

读取和保存

`image.load(filepath)`

读取图片文件。

返回: (Image) 图片对象

`img.save(filepath, options)`

保存图片。

参数:

filepath (string) - 保存路径

options (object) - 选项

quality (number) - 质量(0-100)

format (string) - 格式

尺寸调整

`img.resize(width, height, options)`

调整图片尺寸。

参数:

width (number) - 宽度

height (number) - 高度(可选)

options (object) - 选项

fit (string) - 'cover', 'contain', 'fill'

position (string) - 'center', 'top', 'left' 等

`img.crop(x, y, width, height)`

裁剪图片。

`img.scale(factor)`

按比例缩放。

参数:

factor (number) - 缩放因子(0.5 = 50%)

变换操作

`img.rotate(degrees)`

旋转图片。

参数:

degrees (number) - 旋转角度(0-360)

`img.flipHorizontal()`

水平翻转。

`img.flipVertical()`

垂直翻转。

滤镜效果

`img.grayscale()`

转为灰度图。

`img.blur(radius)`

模糊效果。

参数:

radius (number) - 模糊半径

`img.sharpen()`

锐化效果。

`img.brightness(factor)`

调整亮度。

参数:

factor (number) - 亮度因子(1.0 = 原始)

合成操作

`img.composite(overlay, options)`

合成图片。

参数:

overlay (Image) - 叠加图片

options (object) - 选项

x (number) - X 坐标

y (number) - Y 坐标

opacity (number) - 透明度(0-1)

实际应用场景

生成缩略图

批量添加水印

图片优化

照片墙生成

证件照处理

最佳实践

内存管理 - 处理大图片后及时释放内存

质量权衡 - 平衡图片质量和文件大小

格式选择 - WebP 适合网络,PNG 适合透明图

批量处理 - 使用异步避免阻塞

错误处理 - 捕获图片加载和处理错误

原图备份 - 处理前备份原始图片

支持的格式

格式	读取	写入	特点
JPEG	✓	✓	有损压缩,适合照片
PNG	✓	✓	无损压缩,支持透明
GIF	✓	✓	支持动画
WebP	✓	✓	现代格式,体积小
BMP	✓	✓	无压缩,体积大
TIFF	✓	✓	专业格式

image

Image 模块#

功能特性#

基本使用#

引入模块#

读取图片#

缩放图片#

裁剪图片#

格式转换#

旋转和翻转#

滤镜效果#

添加水印#

文字水印#

API 参考#

读取和保存#

image.load(filepath)#

img.save(filepath, options)#

尺寸调整#

img.resize(width, height, options)#

img.crop(x, y, width, height)#

img.scale(factor)#

变换操作#

img.rotate(degrees)#

img.flipHorizontal()#

img.flipVertical()#

滤镜效果#

img.grayscale()#

img.blur(radius)#

img.sharpen()#

img.brightness(factor)#

合成操作#

img.composite(overlay, options)#

实际应用场景#

生成缩略图#

批量添加水印#

图片优化#

照片墙生成#

证件照处理#

最佳实践#

支持的格式#

相关模块#

Image 模块

功能特性

基本使用

引入模块

读取图片

缩放图片

裁剪图片

格式转换

旋转和翻转

滤镜效果

添加水印

文字水印

API 参考

读取和保存

`image.load(filepath)`

`img.save(filepath, options)`

尺寸调整

`img.resize(width, height, options)`

`img.crop(x, y, width, height)`

`img.scale(factor)`

变换操作

`img.rotate(degrees)`

`img.flipHorizontal()`

`img.flipVertical()`

滤镜效果

`img.grayscale()`

`img.blur(radius)`

`img.sharpen()`

`img.brightness(factor)`

合成操作

`img.composite(overlay, options)`

实际应用场景

生成缩略图

批量添加水印

图片优化

照片墙生成

证件照处理

最佳实践

支持的格式

相关模块