图像处理 API
Sharp 提供了丰富的图像处理功能，包括调整大小、裁剪、旋转、滤镜等操作。
调整大小 (resize)
基本用法
javascript
import sharp from 'sharp';
// 调整到指定尺寸
sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
// 只指定宽度，高度自动计算
sharp('input.jpg')
.resize(300)
.toFile('output.jpg');
// 只指定高度，宽度自动计算
sharp('input.jpg')
.resize(null, 200)
.toFile('output.jpg');调整选项
javascript
sharp('input.jpg')
.resize(300, 200, {
// 调整算法
kernel: sharp.kernel.lanczos3,
// 位置
position: 'center',
// 背景色
background: { r: 255, g: 255, b: 255, alpha: 1 },
// 是否保持宽高比
fit: 'cover',
// 是否不放大
withoutEnlargement: true,
// 是否不缩小
withoutReduction: false
})
.toFile('output.jpg');调整算法
javascript
// 可用的调整算法
sharp.kernel.nearest // 最近邻
sharp.kernel.cubic // 三次插值
sharp.kernel.mitchell // Mitchell-Netravali
sharp.kernel.lanczos2 // Lanczos 2-lobed
sharp.kernel.lanczos3 // Lanczos 3-lobed (默认)适应模式
javascript
// cover: 保持宽高比，裁剪超出部分
sharp('input.jpg').resize(300, 200, { fit: 'cover' })
// contain: 保持宽高比，添加背景
sharp('input.jpg').resize(300, 200, { fit: 'contain' })
// fill: 拉伸到指定尺寸
sharp('input.jpg').resize(300, 200, { fit: 'fill' })
// inside: 保持宽高比，不超出原图尺寸
sharp('input.jpg').resize(300, 200, { fit: 'inside' })
// outside: 保持宽高比，至少达到指定尺寸
sharp('input.jpg').resize(300, 200, { fit: 'outside' })裁剪 (extract)
javascript
// 裁剪指定区域
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.toFile('output.jpg');
// 裁剪并调整大小
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.resize(150, 100)
.toFile('output.jpg');旋转 (rotate)
javascript
// 旋转90度
sharp('input.jpg')
.rotate(90)
.toFile('output.jpg');
// 旋转并指定背景色
sharp('input.jpg')
.rotate(45, { background: { r: 255, g: 255, b: 255, alpha: 1 } })
.toFile('output.jpg');翻转 (flip/flop)
javascript
// 垂直翻转
sharp('input.jpg')
.flip()
.toFile('output.jpg');
// 水平翻转
sharp('input.jpg')
.flop()
.toFile('output.jpg');模糊 (blur)
javascript
// 高斯模糊
sharp('input.jpg')
.blur(5)
.toFile('output.jpg');
// 锐化
sharp('input.jpg')
.sharpen()
.toFile('output.jpg');
// 自定义锐化参数
sharp('input.jpg')
.sharpen({
sigma: 1,
flat: 1,
jagged: 2
})
.toFile('output.jpg');滤镜 (filters)
灰度
javascript
sharp('input.jpg')
.grayscale()
.toFile('output.jpg');反转
javascript
sharp('input.jpg')
.negate()
.toFile('output.jpg');伽马校正
javascript
sharp('input.jpg')
.gamma(2.2)
.toFile('output.jpg');亮度/对比度
javascript
sharp('input.jpg')
.modulate({
brightness: 1.2, // 亮度 (0.1-2.0)
saturation: 0.8, // 饱和度 (0-2.0)
hue: 180 // 色相 (0-360)
})
.toFile('output.jpg');颜色操作
色调分离
javascript
sharp('input.jpg')
.tint({ r: 255, g: 0, b: 0 })
.toFile('output.jpg');颜色矩阵
javascript
sharp('input.jpg')
.recomb([
[0.3588, 0.7044, 0.1368],
[0.2990, 0.5870, 0.1140],
[0.0000, 0.0000, 1.0000]
])
.toFile('output.jpg');通道操作
分离通道
javascript
// 获取红色通道
sharp('input.jpg')
.extractChannel('red')
.toFile('red-channel.jpg');
// 获取所有通道
const channels = await sharp('input.jpg').separate();合并通道
javascript
// 从单独的通道文件合并
sharp('red.jpg')
.joinChannel(['green.jpg', 'blue.jpg'])
.toFile('merged.jpg');组合操作
javascript
// 链式操作
sharp('input.jpg')
.resize(800, 600)
.rotate(90)
.blur(2)
.sharpen()
.jpeg({ quality: 80 })
.toFile('output.jpg');性能优化
流式处理
javascript
const fs = require('fs');
fs.createReadStream('input.jpg')
.pipe(sharp().resize(300, 200))
.pipe(fs.createWriteStream('output.jpg'));批量处理
javascript
const sharp = require('sharp');
const fs = require('fs').promises;
async function processImages() {
const files = await fs.readdir('./images');
const promises = files
.filter(file => file.endsWith('.jpg'))
.map(async file => {
await sharp(`./images/${file}`)
.resize(300, 200)
.jpeg({ quality: 80 })
.toFile(`./output/${file}`);
});
await Promise.all(promises);
}错误处理
javascript
try {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} catch (error) {
console.error('图像处理失败:', error.message);
}