الأمثلة الأساسية

توفر هذه الصفحة بعض أمثلة الاستخدام الأساسي لـ Sharp لمساعدتك على البدء بسرعة.

تغيير حجم الصور

تغيير الحجم البسيط

import sharp from 'sharp';

// تغيير إلى حجم محدد
await sharp('input.jpg')
  .resize(300, 200)
  .toFile('output.jpg');

الحفاظ على نسبة العرض إلى الارتفاع

// تحديد العرض فقط، يتم حساب الارتفاع تلقائيًا
await sharp('input.jpg')
  .resize(300)
  .toFile('output.jpg');

// تحديد الارتفاع فقط، يتم حساب العرض تلقائيًا
await sharp('input.jpg')
  .resize(null, 200)
  .toFile('output.jpg');

أوضاع التكيف

// cover: الحفاظ على نسبة العرض إلى الارتفاع، قص الأجزاء الزائدة
await sharp('input.jpg')
  .resize(300, 200, { fit: 'cover' })
  .toFile('output.jpg');

// contain: الحفاظ على نسبة العرض إلى الارتفاع، إضافة خلفية
await sharp('input.jpg')
  .resize(300, 200, { fit: 'contain', background: { r: 255, g: 255, b: 255 } })
  .toFile('output.jpg');

تحويل التنسيق

JPEG إلى PNG

await sharp('input.jpg')
  .png()
  .toFile('output.png');

PNG إلى JPEG

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

التحويل إلى WebP

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

التحويل إلى AVIF

await sharp('input.jpg')
  .avif({ quality: 80 })
  .toFile('output.avif');

تدوير الصور

تدوير 90 درجة

await sharp('input.jpg')
  .rotate(90)
  .toFile('output.jpg');

التدوير التلقائي (حسب EXIF)

await sharp('input.jpg')
  .rotate()  // تدوير تلقائي
  .toFile('output.jpg');

قلب الصور

قلب عمودي

await sharp('input.jpg')
  .flip()
  .toFile('output.jpg');

قلب أفقي

await sharp('input.jpg')
  .flop()
  .toFile('output.jpg');

قص الصور

قص منطقة محددة

await sharp('input.jpg')
  .extract({ left: 100, top: 100, width: 300, height: 200 })
  .toFile('output.jpg');

القص وتغيير الحجم

await sharp('input.jpg')
  .extract({ left: 100, top: 100, width: 300, height: 200 })
  .resize(150, 100)
  .toFile('output.jpg');

تأثيرات الفلتر

التحويل إلى التدرج الرمادي

await sharp('input.jpg')
  .grayscale()
  .toFile('output.jpg');

تأثير الضبابية

await sharp('input.jpg')
  .blur(5)
  .toFile('output.jpg');

تأثير الحدّة

await sharp('input.jpg')
  .sharpen()
  .toFile('output.jpg');

عكس الألوان

await sharp('input.jpg')
  .negate()
  .toFile('output.jpg');

تعديل الألوان

تعديل السطوع

await sharp('input.jpg')
  .modulate({ brightness: 1.2 })
  .toFile('output.jpg');

تعديل التشبع

await sharp('input.jpg')
  .modulate({ saturation: 0.8 })
  .toFile('output.jpg');

تعديل الصبغة

await sharp('input.jpg')
  .modulate({ hue: 180 })
  .toFile('output.jpg');

معالجة الشفافية

إضافة الشفافية

await sharp('input.jpg')
  .ensureAlpha()
  .png()
  .toFile('output.png');

إزالة الشفافية

await sharp('input.png')
  .flatten({ background: { r: 255, g: 255, b: 255 } })
  .jpeg()
  .toFile('output.jpg');

إعدادات الجودة

جودة JPEG

// جودة عالية
await sharp('input.png')
  .jpeg({ quality: 95 })
  .toFile('output.jpg');

// جودة متوسطة
await sharp('input.png')
  .jpeg({ quality: 80 })
  .toFile('output.jpg');

// جودة منخفضة (ملف صغير)
await sharp('input.png')
  .jpeg({ quality: 50 })
  .toFile('output.jpg');

جودة WebP

await sharp('input.jpg')
  .webp({ quality: 80, lossless: false })
  .toFile('output.webp');

العمليات المتسلسلة

دمج عمليات متعددة

await sharp('input.jpg')
  .resize(800, 600)
  .rotate(90)
  .blur(2)
  .sharpen()
  .jpeg({ quality: 80 })
  .toFile('output.jpg');

المعالجة الشرطية

const image = sharp('input.jpg').resize(300, 200);

if (needsBlur) {
  image.blur(3);
}

if (needsSharpen) {
  image.sharpen();
}

await image.jpeg({ quality: 80 }).toFile('output.jpg');

معالجة الأخطاء

معالجة الأخطاء الأساسية

try {
  await sharp('input.jpg')
    .resize(300, 200)
    .toFile('output.jpg');
} catch (error) {
  console.error('فشلت معالجة الصورة:', error.message);
}

التحقق من وجود الملف

const fs = require('fs');

if (fs.existsSync('input.jpg')) {
  await sharp('input.jpg')
    .resize(300, 200)
    .toFile('output.jpg');
} else {
  console.error('ملف الإدخال غير موجود');
}

المعالجة المتدفقة

القراءة من التدفق

const fs = require('fs');

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

الإخراج إلى التدفق

const fs = require('fs');

sharp('input.jpg')
  .resize(300, 200)
  .jpeg({ quality: 80 })
  .pipe(fs.createWriteStream('output.jpg'));

معالجة Buffer

الإنشاء من Buffer

const fs = require('fs');

const inputBuffer = fs.readFileSync('input.jpg');
const outputBuffer = await sharp(inputBuffer)
  .resize(300, 200)
  .jpeg({ quality: 80 })
  .toBuffer();

fs.writeFileSync('output.jpg', outputBuffer);

الإخراج إلى Buffer

const buffer = await sharp('input.jpg')
  .resize(300, 200)
  .jpeg({ quality: 80 })
  .toBuffer();

// يمكن استخدام buffer مباشرة
console.log('حجم الصورة:', buffer.length);

المعالجة المجمعة

معالجة جميع الصور في المجلد

const fs = require('fs').promises;
const path = require('path');

async function processImages(inputDir, outputDir) {
  const files = await fs.readdir(inputDir);
  
  for (const file of files) {
    if (file.match(/\.(jpg|jpeg|png|webp)$/i)) {
      try {
        await sharp(path.join(inputDir, file))
          .resize(300, 200)
          .jpeg({ quality: 80 })
          .toFile(path.join(outputDir, file));
        
        console.log(`اكتملت المعالجة: ${file}`);
      } catch (error) {
        console.error(`فشلت المعالجة ${file}:`, error.message);
      }
    }
  }
}

processImages('./input', './output');

روابط ذات صلة

• أمثلة متقدمة
• أمثلة تحسين الأداء
• مرجع واجهة برمجة التطبيقات
• دليل التثبيت