API de Processamento de Imagem
Sharp fornece recursos ricos de processamento de imagem, incluindo operações como redimensionamento, corte, rotação e filtros.
Redimensionamento (resize)
Uso Básico
javascript
import sharp from 'sharp';
// Redimensionar para tamanho especificado
sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
// Especificar apenas largura, altura calculada automaticamente
sharp('input.jpg')
.resize(300)
.toFile('output.jpg');
// Especificar apenas altura, largura calculada automaticamente
sharp('input.jpg')
.resize(null, 200)
.toFile('output.jpg');Opções de Redimensionamento
javascript
sharp('input.jpg')
.resize(300, 200, {
// Algoritmo de redimensionamento
kernel: sharp.kernel.lanczos3,
// Posição
position: 'center',
// Cor de fundo
background: { r: 255, g: 255, b: 255, alpha: 1 },
// Se manter proporção
fit: 'cover',
// Se não ampliar
withoutEnlargement: true,
// Se não reduzir
withoutReduction: false
})
.toFile('output.jpg');Algoritmos de Redimensionamento
javascript
// Algoritmos de redimensionamento disponíveis
sharp.kernel.nearest // Vizinho mais próximo
sharp.kernel.cubic // Interpolação cúbica
sharp.kernel.mitchell // Mitchell-Netravali
sharp.kernel.lanczos2 // Lanczos 2-lobed
sharp.kernel.lanczos3 // Lanczos 3-lobed (padrão)Modos de Ajuste
javascript
// cover: Manter proporção, cortar partes excedentes
sharp('input.jpg').resize(300, 200, { fit: 'cover' })
// contain: Manter proporção, adicionar fundo
sharp('input.jpg').resize(300, 200, { fit: 'contain' })
// fill: Esticar para tamanho especificado
sharp('input.jpg').resize(300, 200, { fit: 'fill' })
// inside: Manter proporção, não exceder tamanho original
sharp('input.jpg').resize(300, 200, { fit: 'inside' })
// outside: Manter proporção, pelo menos atingir tamanho especificado
sharp('input.jpg').resize(300, 200, { fit: 'outside' })Corte (extract)
javascript
// Cortar região especificada
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.toFile('output.jpg');
// Cortar e redimensionar
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.resize(150, 100)
.toFile('output.jpg');Rotação (rotate)
javascript
// Rotacionar 90 graus
sharp('input.jpg')
.rotate(90)
.toFile('output.jpg');
// Rotacionar e especificar cor de fundo
sharp('input.jpg')
.rotate(45, { background: { r: 255, g: 255, b: 255, alpha: 1 } })
.toFile('output.jpg');Inversão (flip/flop)
javascript
// Inverter verticalmente
sharp('input.jpg')
.flip()
.toFile('output.jpg');
// Inverter horizontalmente
sharp('input.jpg')
.flop()
.toFile('output.jpg');Desfoque (blur)
javascript
// Desfoque gaussiano
sharp('input.jpg')
.blur(5)
.toFile('output.jpg');
// Nitidez
sharp('input.jpg')
.sharpen()
.toFile('output.jpg');
// Parâmetros de nitidez personalizados
sharp('input.jpg')
.sharpen({
sigma: 1,
flat: 1,
jagged: 2
})
.toFile('output.jpg');Filtros
Escala de Cinza
javascript
sharp('input.jpg')
.grayscale()
.toFile('output.jpg');Negativo
javascript
sharp('input.jpg')
.negate()
.toFile('output.jpg');Correção Gama
javascript
sharp('input.jpg')
.gamma(2.2)
.toFile('output.jpg');Brilho/Contraste
javascript
sharp('input.jpg')
.modulate({
brightness: 1.2, // Brilho (0.1-2.0)
saturation: 0.8, // Saturação (0-2.0)
hue: 180 // Matiz (0-360)
})
.toFile('output.jpg');Operações de Cor
Separação de Tons
javascript
sharp('input.jpg')
.tint({ r: 255, g: 0, b: 0 })
.toFile('output.jpg');Matriz de Cores
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');Operações de Canal
Separar Canais
javascript
// Obter canal vermelho
sharp('input.jpg')
.extractChannel('red')
.toFile('red-channel.jpg');
// Obter todos os canais
const channels = await sharp('input.jpg').separate();Combinar Canais
javascript
// Combinar a partir de arquivos de canal separados
sharp('red.jpg')
.joinChannel(['green.jpg', 'blue.jpg'])
.toFile('merged.jpg');Operações Combinadas
javascript
// Operações encadeadas
sharp('input.jpg')
.resize(800, 600)
.rotate(90)
.blur(2)
.sharpen()
.jpeg({ quality: 80 })
.toFile('output.jpg');Otimização de Performance
Processamento em Stream
javascript
const fs = require('fs');
fs.createReadStream('input.jpg')
.pipe(sharp().resize(300, 200))
.pipe(fs.createWriteStream('output.jpg'));Processamento em Lote
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);
}Tratamento de Erros
javascript
try {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} catch (error) {
console.error('Processamento de imagem falhou:', error.message);
}