API de Procesamiento de Imágenes
Sharp proporciona funciones ricas para el procesamiento de imágenes, incluyendo operaciones como redimensionamiento, recorte, rotación y filtros.
Redimensionamiento (resize)
Uso Básico
javascript
import sharp from 'sharp';
// Redimensionar a tamaño especificado
sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
// Solo especificar ancho, alto se calcula automáticamente
sharp('input.jpg')
.resize(300)
.toFile('output.jpg');
// Solo especificar alto, ancho se calcula automáticamente
sharp('input.jpg')
.resize(null, 200)
.toFile('output.jpg');Opciones de Redimensionamiento
javascript
sharp('input.jpg')
.resize(300, 200, {
// Algoritmo de redimensionamiento
kernel: sharp.kernel.lanczos3,
// Posición
position: 'center',
// Color de fondo
background: { r: 255, g: 255, b: 255, alpha: 1 },
// Si mantener relación de aspecto
fit: 'cover',
// Si no ampliar
withoutEnlargement: true,
// Si no reducir
withoutReduction: false
})
.toFile('output.jpg');Algoritmos de Redimensionamiento
javascript
// Algoritmos de redimensionamiento disponibles
sharp.kernel.nearest // Vecino más cercano
sharp.kernel.cubic // Interpolación cúbica
sharp.kernel.mitchell // Mitchell-Netravali
sharp.kernel.lanczos2 // Lanczos 2-lobed
sharp.kernel.lanczos3 // Lanczos 3-lobed (por defecto)Modos de Ajuste
javascript
// cover: Mantener relación de aspecto, recortar partes excedentes
sharp('input.jpg').resize(300, 200, { fit: 'cover' })
// contain: Mantener relación de aspecto, agregar fondo
sharp('input.jpg').resize(300, 200, { fit: 'contain' })
// fill: Estirar a tamaño especificado
sharp('input.jpg').resize(300, 200, { fit: 'fill' })
// inside: Mantener relación de aspecto, no exceder tamaño original
sharp('input.jpg').resize(300, 200, { fit: 'inside' })
// outside: Mantener relación de aspecto, alcanzar al menos el tamaño especificado
sharp('input.jpg').resize(300, 200, { fit: 'outside' })Recorte (extract)
javascript
// Recortar región especificada
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.toFile('output.jpg');
// Recortar y redimensionar
sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.resize(150, 100)
.toFile('output.jpg');Rotación (rotate)
javascript
// Rotar 90 grados
sharp('input.jpg')
.rotate(90)
.toFile('output.jpg');
// Rotar y especificar color de fondo
sharp('input.jpg')
.rotate(45, { background: { r: 255, g: 255, b: 255, alpha: 1 } })
.toFile('output.jpg');Volteo (flip/flop)
javascript
// Volteo vertical
sharp('input.jpg')
.flip()
.toFile('output.jpg');
// Volteo horizontal
sharp('input.jpg')
.flop()
.toFile('output.jpg');Desenfoque (blur)
javascript
// Desenfoque gaussiano
sharp('input.jpg')
.blur(5)
.toFile('output.jpg');
// Nitidez
sharp('input.jpg')
.sharpen()
.toFile('output.jpg');
// Parámetros personalizados de nitidez
sharp('input.jpg')
.sharpen({
sigma: 1,
flat: 1,
jagged: 2
})
.toFile('output.jpg');Filtros
Escala de Grises
javascript
sharp('input.jpg')
.grayscale()
.toFile('output.jpg');Inversión
javascript
sharp('input.jpg')
.negate()
.toFile('output.jpg');Corrección Gamma
javascript
sharp('input.jpg')
.gamma(2.2)
.toFile('output.jpg');Brillo/Contraste
javascript
sharp('input.jpg')
.modulate({
brightness: 1.2, // Brillo (0.1-2.0)
saturation: 0.8, // Saturación (0-2.0)
hue: 180 // Tono (0-360)
})
.toFile('output.jpg');Operaciones de Color
Tinte
javascript
sharp('input.jpg')
.tint({ r: 255, g: 0, b: 0 })
.toFile('output.jpg');Matriz de Color
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');Operaciones de Canales
Separar Canales
javascript
// Obtener canal rojo
sharp('input.jpg')
.extractChannel('red')
.toFile('red-channel.jpg');
// Obtener todos los canales
const channels = await sharp('input.jpg').separate();Combinar Canales
javascript
// Combinar desde archivos de canales separados
sharp('red.jpg')
.joinChannel(['green.jpg', 'blue.jpg'])
.toFile('merged.jpg');Operaciones Combinadas
javascript
// Operaciones encadenadas
sharp('input.jpg')
.resize(800, 600)
.rotate(90)
.blur(2)
.sharpen()
.jpeg({ quality: 80 })
.toFile('output.jpg');Optimización de Rendimiento
Procesamiento por Streams
javascript
const fs = require('fs');
fs.createReadStream('input.jpg')
.pipe(sharp().resize(300, 200))
.pipe(fs.createWriteStream('output.jpg'));Procesamiento por Lotes
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);
}Manejo de Errores
javascript
try {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} catch (error) {
console.error('Procesamiento de imagen fallido:', error.message);
}