画像処理 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);
}