مثال كامل يعمل لتحويل SVG إلى PNG في Node.JS

يوضح هذا المثال كيفية تحويل ملف SVG مخزن في GroupDocs Cloud storage إلى صورة PNG باستخدام GroupDocs.Conversion Cloud SDK for Node.JS.

const { Configuration, ConvertApi, ConvertDocumentRequest, ConvertSettings, PngOptions, StorageApi, DownloadFileRequest } = require("@groupdocs/conversion-cloud");
const fs = require('fs');
const path = require('path');

// -----------------------------------------------------------------------------
// Configuration – replace with your own credentials
// -----------------------------------------------------------------------------
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

const convertApi = new ConvertApi(config);
const storageApi = new StorageApi(config);

// -----------------------------------------------------------------------------
// Define source SVG and target PNG locations inside GroupDocs Cloud storage
// -----------------------------------------------------------------------------
const inputSvgPath = "input/sample.svg";          // SVG stored in cloud storage
const outputPngPath = "output/sample.png";       // Desired PNG location

// -----------------------------------------------------------------------------
// PNG conversion options – set dimensions to control memory/CPU usage
// -----------------------------------------------------------------------------
const pngOptions = new PngOptions({
    width: 1024,               // Resize width (optional)
    height: 768,               // Resize height (optional)
    backgroundColor: "#FFFFFF" // Ensure opaque background
});

// -----------------------------------------------------------------------------
// Build conversion settings object
// -----------------------------------------------------------------------------
const convertSettings = new ConvertSettings({
    filePath: inputSvgPath,
    format: "png",
    outputPath: outputPngPath,
    options: pngOptions
});

const convertRequest = new ConvertDocumentRequest(convertSettings);

// -----------------------------------------------------------------------------
// Execute conversion, then download the PNG locally
// -----------------------------------------------------------------------------
convertApi.convertDocument(convertRequest)
    .then(convResult => {
        console.log("Conversion succeeded. Cloud file:", convResult.path);
        const downloadReq = new DownloadFileRequest({ path: convResult.path });
        return storageApi.downloadFile(downloadReq);
    })
    .then(fileBuffer => {
        const localFile = path.resolve(__dirname, "sample.png");
        fs.writeFileSync(localFile, fileBuffer);
        console.log("PNG downloaded to:", localFile);
    })
    .catch(err => {
        console.error("Error during SVG → PNG conversion:", err);
    })
    .finally(() => {
        // Clean up HTTP client resources if the SDK exposes a close method
        if (config && config.httpClient && typeof config.httpClient.close === "function") {
            config.httpClient.close();
        }
    });

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input/sample.svg, output/sample.png, إلخ) لتتناسب مع مواقع ملفاتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل SVG إلى PNG عبر REST API باستخدام cURL

إذا كنت تفضل نهج REST النقي، يمكن إجراء نفس التحويل باستخدام أوامر cURL. تُظهر الخطوات أدناه كيفية الحصول على رمز الوصول، تحميل ملف SVG، بدء التحويل، وتنزيل ملف PNG.

المصادقة والحصول على رمز الوصول

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

تحتوي الاستجابة على access_token الذي ستستخدمه في المكالمات اللاحقة.

تحميل ملف SVG المصدر

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input/sample.svg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/local/sample.svg"

تنفيذ تحويل SVG إلى PNG

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "input/sample.svg",
           "format": "png",
           "outputPath": "output/sample.png",
           "options": {
               "width": 1024,
               "height": 768,
               "backgroundColor": "#FFFFFF"
           }
         }'

تُعيد الواجهة البرمجية (API) مسار ملف PNG الذي تم إنشاؤه حديثًا في التخزين السحابي.

تحميل ملف PNG الناتج

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

تمنحك أوامر cURL هذه تحكمًا كاملاً في عملية التحويل دون كتابة أي شفرة. لمزيد من التفاصيل، راجع وثائق API الرسمية.

كيفية تحويل SVG إلى PNG في Node.JS

1. استيراد فئات SDK - يتم تحميل الفئات الأساسية مثل ConvertApi و ConvertSettings و PngOptions بواسطة تعليمة require("@groupdocs/conversion-cloud") (مرجع API).

   const { ConvertApi, ConvertSettings, PngOptions } = require("@groupdocs/conversion-cloud");
   

2. تكوين المصادقة - كائن Configuration يحتوي على clientId و clientSecret الخاصين بك. يتم تمرير هذا الكائن إلى كل من ConvertApi و StorageApi لتفويض جميع المكالمات اللاحقة.

   const config = new Configuration({ clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET" });
   

3. تحديد مسارات الإدخال والإخراج - inputSvgPath يشير إلى ملف SVG في التخزين السحابي، بينما outputPngPath يحدد المكان الذي يجب حفظ ملف PNG فيه.

   const inputSvgPath = "input/sample.svg";
   const outputPngPath = "output/sample.png";
   

4. تعيين خيارات PNG - PngOptions يتيح لك التحكم في الأبعاد ولون الخلفية، وهو مفيد للرسومات المتجهة الكبيرة أو الشفافة (SVGs).

   const pngOptions = new PngOptions({ width: 1024, height: 768, backgroundColor: "#FFFFFF" });
   

5. إنشاء إعدادات التحويل وتنفيذها - ConvertSettings يجمع مسار الملف، التنسيق المستهدف، موقع الإخراج، والخيارات. طريقة convertDocument تقوم بإجراء التحويل، والنتيجة تحتوي على مسار السحابة لملف PNG.

const convertSettings = new ConvertSettings({ filePath: inputSvgPath, format: "png", outputPath: outputPngPath, options: pngOptions });
const convertRequest = new ConvertDocumentRequest(convertSettings);
convertApi.convertDocument(convertRequest);

6. تنزيل PNG - بعد التحويل، StorageApi.downloadFile يسترجع البيانات الثنائية، والتي يمكنك كتابتها إلى نظام الملفات المحلي.

فهم كل خطوة يساعدك على تخصيص العملية، ومعالجة الأخطاء، وتكامل التحويل في سير عمل أكبر.

التثبيت والتهيئة GroupDocs.Conversion Cloud SDK for Node.JS

npm install groupdocs-conversion-cloud

يتطلب SDK Node.js 12 أو أحدث. بعد التثبيت، أنشئ كائن تكوين يحتوي على clientId و clientSecret (متاحين من حساب GroupDocs Cloud الخاص بك). راجع صفحة التحميل للحصول على أحدث إصدار من الحزمة.

const { Configuration } = require("@groupdocs/conversion-cloud");
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

تأكد من أن بيانات الاعتماد لديها إذن للوصول إلى خدمات التخزين والتحويل. بمجرد التكوين، يمكنك إنشاء كائنات ConvertApi و StorageApi كما هو موضح في مثال الشيفرة.

ضبط إعدادات تحويل PNG

تقدم فئة PngOptions عدة خصائص يمكنك تعديلها:

• width / height - تعريف دقة الإخراج. القيم الأكبر تزيد الجودة ولكنها تستهلك المزيد من الذاكرة.

  const pngOptions = new PngOptions({ width: 1920, height: 1080 });
  

• backgroundColor - تعيين خلفية صلبة للرسومات SVG التي تحتوي على شفافية.

  const pngOptions = new PngOptions({ backgroundColor: "#000000" });
  

• compressionLevel - (إذا كان مدعومًا) اختر مستوى ضغط بين 0 (بدون ضغط) و 9 (أقصى ضغط) لتقليل حجم الملف.

  const pngOptions = new PngOptions({ compressionLevel: 6 });
  

يتم تمرير هذه الخيارات عبر خاصية options في ConvertSettings. راجع مرجع API للحصول على القائمة الكاملة للإعدادات المتاحة.

أفضل الممارسات لتحويل SVG إلى PNG بكفاءة

• تحقق من محتوى SVG - تأكد من أن ملف SVG لا يحتوي على سكريبتات خارجية أو حمولة خبيثة قبل التحميل. تقوم GroupDocs.Conversion بتنظيف الإدخال، لكن التحقق المسبق يضيف طبقة أمان إضافية.
• إعادة استخدام كائن Configuration - أنشئ نسخة واحدة من Configuration وشاركها عبر عدة استدعاءات ConvertApi لتقليل الحمل الزائد.
• تحديد أبعاد معقولة - حدِّد العرض والارتفاع إلى الحجم الذي تحتاجه فعليًا. الصور الكبيرة جدًا تزيد من زمن المعالجة واستهلاك الذاكرة.
• تدفق الملفات الكبيرة - بالنسبة لملفات SVG الكبيرة جدًا، فكر في تدفق التنزيل بدلاً من تحميل كامل الذاكرة المؤقتة إلى الذاكرة.
• مراقبة استخدام API - راقب حصتك من التحويل وتعامل مع ردود حدود المعدل (rate‑limit) بلطف.

الخلاصة

GroupDocs.Conversion Cloud SDK for Node.JS يجعل تحويل SVG إلى PNG على الخادم بسيطًا، قابلًا للتوسع، وآمنًا. باتباع مثال الكود الكامل، وسير عمل cURL المكافئ، ونصائح التكوين المذكورة أعلاه، يمكنك دمج تحويل الصور عالي الأداء في أي خدمة خلفية. تذكر مراجعة خيارات الترخيص؛ تتطلب عمليات النشر في الإنتاج اشتراكًا مدفوعًا، ويمكنك الحصول على ترخيص مؤقت للاختبار من صفحة temporary license page. ابدأ التحويل اليوم وقدم ملفات PNG واضحة لمستخدميك بثقة.

الأسئلة المتكررة

كيف أقوم بتحويل SVG إلى PNG في Node.JS باستخدام GroupDocs؟
استخدم GroupDocs.Conversion Cloud SDK for Node.JS. قم بتحميل SVG إلى التخزين السحابي، اضبط PngOptions، استدعِ convertDocument، وحمّل PNG. يوضح مثال الشيفرة الكامل في هذه المقالة كل خطوة.

هل يمكنني تحويل مجموعة من ملفات SVG دفعة واحدة؟
نعم. قم بالتكرار عبر قائمة مسارات SVG واستدعِ طلب التحويل نفسه لكل ملف. يعالج SDK كل طلب بشكل مستقل، مما يتيح لك تخزين جميع نتائج PNG في مجلد إخراج واحد.

ماذا ينبغي عليّ أن أفعل إذا فشل التحويل مع ظهور خطأ؟
تحقق من رسالة الخطأ التي تم إرجاعها في كتلة الـ catch. تشمل المشكلات الشائعة بيانات اعتماد غير صالحة، مسارات ملفات مفقودة، أو ميزات SVG غير مدعومة. راجع التوثيق الرسمي للحصول على رموز الأخطاء التفصيلية وخطوات استكشاف الأخطاء وإصلاحها.

أين يمكنني العثور على مزيد من المعلومات حول خيارات PNG؟
جميع الخصائص القابلة للتكوين مدرجة في مرجع API لـ PngOptions. زر مرجع API لاستكشاف إعدادات إضافية مثل مستوى الضغط وعمق اللون.

اقرأ المزيد

• دليل خطوة بخطوة لتحويل HTML إلى DOCX في Node.JS
• مثال خطوة بخطوة لتحويل CSV إلى PDF في Node.JS
• تحويل PDF إلى DOCX في Node.JS

تحويل CSV إلى JPG في Node.JS - مثال كامل للكود

يوضح هذا المثال كيفية تحويل ملف CSV مخزن في تخزين GroupDocs Cloud إلى صور JPG باستخدام واجهة برمجة التطبيقات غير المتزامنة للمكتبة.

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input.csv, output_images, إلخ) لتطابق المواقع الفعلية للملفات لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل CSV إلى JPG باستخدام cURL و REST API

إذا كنت تفضل نهج REST النقي، يمكن إجراء التحويل نفسه باستخدام سلسلة من أوامر cURL.

1. الحصول على رمز الوصول - المصادقة باستخدام بيانات الاعتماد الخاصة بالعميل.

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. تحميل ملف CSV المصدر - ضع الملف في تخزين GroupDocs Cloud الخاص بك.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/your/input.csv"

3. طلب التحويل - حدد تنسيق الهدف كـ JPG.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'

4. تنزيل الصورة (الصور) المُولَّدة - استرجاع الملفات من مجلد الإخراج.

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output_images/your_image.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o your_image.jpg

هذه الأوامر توضح سير عمل كامل من CSV‑إلى‑JPG دون كتابة أي شفرة. لمزيد من التفاصيل، راجع وثائق API الرسمية.

فهم عملية تحويل CSV إلى JPG في Node.JS

فيما يلي تفصيل خطوة بخطوة للكود المعروض سابقًا:

1. تهيئة عميل API - new ConvertApi(clientId, clientSecret) ينشئ جلسة مُصادقة.

   const convertApi = new ConvertApi(clientId, clientSecret);
   

2. حدد ملف المصدر - كائن FileInfo يشير إلى input.csv المخزن في GroupDocs Cloud.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";

3. تعيين خيارات التحويل - ConvertOptions.format = "jpg" يخبر الخدمة بإنتاج مخرجات بصيغة JPG.

const convertOptions = new ConvertOptions();
convertOptions.fileInfo = fileInfo;
convertOptions.format = "jpg";

4. تكوين إعدادات الإخراج - ConvertSettings.outputPath يحدد مكان حفظ الصور.

   const convertSettings = new ConvertSettings();
   convertSettings.outputPath = "output_images";
   convertSettings.convertOptions = [convertOptions];
   

5. تنفيذ التحويل - convertApi.convertDocument(convertSettings) يرسل الطلب ويعيد مصفوفة من مسارات الملفات التي تم إنشاؤها.

   const result = await convertApi.convertDocument(convertSettings);
   

للحصول على قائمة كاملة بالفئات والخصائص، راجع مرجع API.

المتطلبات والإعداد

1. Node.js runtime - الإصدار 12 أو أعلى مطلوب.
2. GroupDocs Cloud account - احصل على clientId و clientSecret من بوابة GroupDocs.
3. Install the SDK - نفّذ الأمر التالي (حمّل الحزمة من صفحة الإصدار الرسمية):

npm install groupdocs-conversion-cloud

4. استيراد SDK في مشروعك:

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

لمزيد من التفاصيل حول التثبيت، راجع صفحة التحميل.

إعدادات التحويل: الخيارات والمعلمات

SDK يوفّر عدة خصائص يمكنك تعديلها:

• مسار الإخراج - يتحكم في المجلد الذي تُخزن فيه ملفات JPG.

convertSettings.outputPath = "output_images";

• تنسيق الهدف - غيّر "jpg" إلى "jpeg" إذا كنت بحاجة إلى نسخة JPEG.

convertOptions.format = "jpeg";

• أبعاد مخصصة - يمكنك تحديد العرض والارتفاع (إذا كان مدعومًا) لإنشاء صور بالحجم الدقيق.

convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels

• التنفيذ غير المتزامن - تُعيد طرق SDK وعودًا، مما يتيح لك دمج التحويل في سير عمل غير متزامن دون حظر حلقة الأحداث.

await convertApi.convertDocument(convertSettings);

تتيح لك هذه الخيارات تخصيص سير عمل CSV‑to‑JPG ليتناسب مع احتياجاتك المحددة في الأتمتة أو التكامل.

الخاتمة

تحويل CSV إلى JPG في Node.JS سهل مع GroupDocs.Conversion Cloud SDK for Node.js. تتولى المكتبة التعامل مع العمليات الثقيلة في السحابة، مما يتيح لك التركيز على منطق الأعمال والتكامل. تذكر تأمين بيانات اعتماد السحابة الخاصة بك، واختيار تنسيق الإخراج المناسب (JPG أو JPEG)، وضبط الإعدادات مثل الأبعاد أو مسارات الإخراج لتتناسب مع سير عملك. بالنسبة للنشر في بيئة الإنتاج، ستحتاج إلى ترخيص مدفوع؛ يمكنك استكشاف تفاصيل التسعير والحصول على ترخيص مؤقت من صفحة الترخيص المؤقت. مع الشيفرة وأمثلة cURL المقدمة، أنت جاهز لإضافة أتمتة تحويل CSV إلى JPG إلى أي خدمة خلفية.

الأسئلة الشائعة

• كيف يمكنني تحويل CSV إلى JPG في Node.JS دون كتابة منطق تحليل مخصص؟
  يقرأ SDK ملف CSV مباشرةً من تخزين GroupDocs Cloud ويعرض كل صف كصورة، لذلك لا تحتاج إلى أي أدوات خارجية. فقط اتبع مثال الشيفرة أو سير عمل cURL.

• هل من الممكن تحويل CSV إلى JPEG بدلاً من JPG في الخلفية؟
  نعم. قم بتعيين convertOptions.format = "jpeg" في الكود أو استخدم format=jpeg في طلب REST. كلا التنسيقين مدعومان للتحويل في الخلفية باستخدام Node.JS.

• هل يمكنني تشغيل التحويل بشكل غير متزامن لتجنب حجز خادمي؟
  بالتأكيد. جميع طرق SDK تُعيد الوعود، لذا يمكنك await إياها أو إرفاق معالجات .then(). هذا يتيح أتمتة CSV‑to‑JPG غير محجوبة وقابلة للتوسع.

• أين يمكنني العثور على مزيد من أمثلة تحويل CSV إلى صور؟
  الوثائق الرسمية الوثائق تحتوي على عينات إضافية، ومنتدى المجتمع في GroupDocs Conversion Forum هو مكان جيد لطرح الأسئلة.

اقرأ المزيد

• تحويل PDF إلى JPG باستخدام Node.js | استخراج الصور من PDF
• تحويل CSV إلى JSON في Node.js | CSV إلى JSON عبر الإنترنت باستخدام REST API
• تحويل JSON إلى CSV باستخدام Node.js REST API | تحويل JSON إلى تنسيق CSV عبر الإنترنت