Schnellstart

Dieser Leitfaden hilft Ihnen, schnell mit Sharp zu beginnen und grundlegende Bildverarbeitungsoperationen zu erlernen.

Grundlegende Verwendung

Sharp importieren

import sharp from 'sharp';

Oder mit CommonJS:

const sharp = require('sharp');

Bilder lesen

Sharp unterstützt verschiedene Eingabeformate:

// Aus Datei lesen
const image = sharp('input.jpg');

// Aus Buffer lesen
const image = sharp(buffer);

// Aus Stream lesen
const image = sharp(stream);

Grundlegende Operationen

Größe ändern

// Auf bestimmte Größe ändern
await sharp('input.jpg')
  .resize(300, 200)
  .toFile('output.jpg');

// Seitenverhältnis beibehalten
await sharp('input.jpg')
  .resize(300, null) // Breite 300, Höhe automatisch
  .toFile('output.jpg');

// Verschiedene Anpassungsmodi verwenden
await sharp('input.jpg')
  .resize(300, 200, {
    fit: 'cover',    // Zuschneiden zum Anpassen
    position: 'center' // Zentriert zuschneiden
  })
  .toFile('output.jpg');

Formatkonvertierung

// Zu JPEG konvertieren
await sharp('input.png')
  .jpeg({ quality: 80 })
  .toFile('output.jpg');

// Zu WebP konvertieren
await sharp('input.jpg')
  .webp({ quality: 80 })
  .toFile('output.webp');

// Zu PNG konvertieren
await sharp('input.jpg')
  .png({ compressionLevel: 9 })
  .toFile('output.png');

Zuschneiden

// Bestimmten Bereich zuschneiden
await sharp('input.jpg')
  .extract({ left: 100, top: 100, width: 200, height: 200 })
  .toFile('cropped.jpg');

Rotation

// Um 90 Grad rotieren
await sharp('input.jpg')
  .rotate(90)
  .toFile('rotated.jpg');

Erweiterte Operationen

Filtereffekte

// Unschärfe
await sharp('input.jpg')
  .blur(5)
  .toFile('blurred.jpg');

// Schärfung
await sharp('input.jpg')
  .sharpen()
  .toFile('sharpened.jpg');

// Graustufen
await sharp('input.jpg')
  .grayscale()
  .toFile('grayscale.jpg');

Farbanpassung

// Helligkeit anpassen
await sharp('input.jpg')
  .modulate({ brightness: 1.2 })
  .toFile('bright.jpg');

// Kontrast anpassen
await sharp('input.jpg')
  .modulate({ contrast: 1.5 })
  .toFile('contrast.jpg');

// Sättigung anpassen
await sharp('input.jpg')
  .modulate({ saturation: 0.8 })
  .toFile('desaturated.jpg');

Ausgabeoptionen

In Datei speichern

await sharp('input.jpg')
  .resize(300, 200)
  .toFile('output.jpg');

An Buffer ausgeben

const buffer = await sharp('input.jpg')
  .resize(300, 200)
  .jpeg()
  .toBuffer();

An Stream ausgeben

sharp('input.jpg')
  .resize(300, 200)
  .jpeg()
  .pipe(fs.createWriteStream('output.jpg'));

Fehlerbehandlung

try {
  await sharp('input.jpg')
    .resize(300, 200)
    .toFile('output.jpg');
} catch (error) {
  console.error('Bildverarbeitung fehlgeschlagen:', error);
}

Leistungsoptimierung

Stream-Verarbeitung

// Stream für große Dateien verwenden
const pipeline = sharp()
  .resize(300, 200)
  .jpeg({ quality: 80 });

fs.createReadStream('large-input.jpg')
  .pipe(pipeline)
  .pipe(fs.createWriteStream('output.jpg'));

Parallele Verarbeitung

// Mehrere Bilder gleichzeitig verarbeiten
const promises = images.map(image => 
  sharp(image)
    .resize(300, 200)
    .jpeg()
    .toBuffer()
);

const results = await Promise.all(promises);

Vollständiges Beispiel

import sharp from 'sharp';
import fs from 'fs';

async function processImage() {
  try {
    // Vorschaubild erstellen
    await sharp('input.jpg')
      .resize(150, 150, { fit: 'cover' })
      .jpeg({ quality: 90 })
      .toFile('thumbnail.jpg');

    // Mittelgroßes Bild erstellen
    await sharp('input.jpg')
      .resize(800, 600, { fit: 'inside' })
      .webp({ quality: 80 })
      .toFile('medium.webp');

    // Großes Bild erstellen
    await sharp('input.jpg')
      .resize(1920, 1080, { fit: 'inside' })
      .jpeg({ quality: 85 })
      .toFile('large.jpg');

    console.log('Bildverarbeitung abgeschlossen!');
  } catch (error) {
    console.error('Verarbeitung fehlgeschlagen:', error);
  }
}

processImage();

Nächste Schritte

Jetzt, da Sie die Grundlagen von Sharp kennen, können Sie:

• Die API-Dokumentation durchsuchen, um alle verfügbaren Methoden zu erfahren
• Erweiterte Beispiele lernen, um mehr Techniken zu beherrschen
• Leistungsoptimierung verstehen, um die Verarbeitungseffizienz zu steigern