في النظام الرقمي الحديث، الحاجة إلى تحويل PDF المستندات إلى JPG الصور أصبحت أكثر شيوعاً من أي وقت مضى. سواء كنت تبحث عن تصدير PDF كـ JPEG، أو إنشاء معاينات للمستندات، أو معالجة PDF إلى تنسيقات الصور لتطبيقات الويب، يمكن أن توفر الأتمتة الوقت الثمين.

في هذا الدليل، سوف نستكشف كيف يمكننا تطوير تطبيق قوي لتحويل PDF إلى صورة JPG قائم على واجهة برمجة التطبيقات REST القابلة للتوسع.

لماذا تحويل PDF إلى JPG أو JPEG؟

  • توليد المعاينة – عرض صفحات PDF كصور في تطبيقات الويب أو أنظمة المحتوى.
  • مشاركة سهلة – صور JPG متوافقة عالميًا عبر الأجهزة.
  • عالي الدقة – حافظ على الألوان والتخطيط والرسوم المتجهة.
  • Automation-ready – مثالي لمعالجة الوثائق في الخلفية.
  • قابلية التوسع – تحويل ملفات PDF متعددة إلى JPG بكفاءة دون عناء.

API تحويل PDF

تقدم GroupDocs.Conversion Cloud SDK for .NET حلاً معتمدًا على السحابة لتحويل PDF إلى JPG، من بين العديد من التنسيقات الأخرى. يدعم العشرات من أنواع الوثائق والصور، مما يوفر لك وسيلة سهلة لتصدير PDF كملف JPEG أو أنواع أخرى من الملفات مباشرةً من تطبيقات .NET.

البدء

قبل أن نبدأ عملية التحويل، تأكد من أن لديك:

  1. حساب GroupDocs Cloud account مع معرف العميل وسر العميل.
  2. A sample PDF file to test conversion.
  3. بيئة .NET مُهيأة (Visual Studio، Visual Studio Code، أو IDE أخرى مدعومة).

قم بتثبيت حزمة SDK عبر مدير حزم NuGet:

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

كيفية تحويل PDF إلى JPG في C#

اتبع هذه الخطوات البسيطة لتحويل PDF إلى صورة بتنسيق (JPG) باستخدام واجهة برمجة التطبيقات REST الخاصة بـ .NET:

الخطوة 1. - أنشئ مثيل من فئات Configuration و ConvertApi و FileApi.

var configurations = new Configuration(clientId, clientSecret1);
var convertApi = new ConvertApi(configurations);
var fileApi = new FileApi(configuration);

خطوة 2. - رفع ملف PDF إلى تخزين سحابي.

using (var fileStream = File.OpenRead("sample.pdf"))
{
    var uploadRequest = new UploadFileRequest("sample.pdf", fileStream);
    fileApi.UploadFile(uploadRequest);
}

الخطوة 3. - قم بتعريف ConvertSettings لتحويل PDF → JPG.

var settings = new ConvertSettings
{
    FilePath = "input.pdf",
    Format = "jpg",
    OutputPath = "converted/pdf-to-jpg/"
};

الخطوة 4. - استخدم طريقة ConvertDocument(...) لبدء تحويل PDF إلى JPG.

var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
  • يتم تحويل كل صفحة من مستند PDF إلى صورة JPG منفصلة، ويتم تخزينها في مجلد الإخراج.
// للمزيد من الأمثلة، يرجى زيارة https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// احصل على بيانات اعتماد العميل من https://dashboard.groupdocs.cloud/

string clientId = "XXXXXX-XXXXXXXXX-XXXXXXX";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";

// أنشئ مثيلًا من فئة Configuration مع تمرير معرف العميل و السر الخاص بالعميل كوسائط. 
var configurations = new Configuration(clientId, clientSecret1);
// حدد قيمة ApiBaseUrl.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// قم بتهيئة مثيل من فئة ConvertApi باستخدام كائن من فئة Configuration.
var convertApi = new ConvertApi(configurations);
// إنشاء مثيل من FileApi
var fileApi = new FileApi(configuration);             

// load the input PDF from local drive.             
using (var stream = OpenRead("sample.pdf"))
{
    // upload the input PDF to the cloud storage.
    fileApi.UploadFile(new UploadFileRequest("sample.pdf", stream));

    // create ConvertSettings where we specify resultant output as JPEG.
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "sample.pdf",
        Format = "jpg",
        OutputPath = "converted/pdf-to-jpg/"
    };
    
    // استدعِ طريقة ConvertDocument لتصدير صفحات PDF كصور JPEG.
    var response = convertApi.ConvertDocument(new ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // print success message
        Console.WriteLine("PDF to JPEG images conversion completed successfully.");
    }
}

تصدير PDF كصور JPEG باستخدام cURL

إذا كنت تفضل نهج قائم على النص، يمكنك أيضًا تحويل PDF إلى JPG باستخدام GroupDocs.Conversion Cloud REST API و cURL.

لماذا نستخدم cURL لتحويل PDF إلى JPG؟

  • مثالي لخطوط أنابيب التشغيل الآلي أو تكامل CI/CD.
  • لا حاجة لتثبيت SDK.
  • مثالي للبيئات الخالية من الرأس أو الخوادم.

أولاً، قم بإنشاء رمز الوصول JWT الخاص بك عند استخدام بيانات اعتماد العميل ثم، نفذ الأمر التالي لتصدير PDF إلى تنسيق صورة JPEG:

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H  "Content-Type: application/json" \
-d "{  \"FilePath\": \"{inputFile}\",  \"Format\": \"jpg\",  \"LoadOptions\": {    \"Format\": \"JPG\"  },\"OutputPath\": \"{resultantFile}\"}"

استبدل {ACCESSTOKEN} برمز JWT ، و inputFile باسم ملف PDF ، و resultantFile باسم صورة JPEG الناتجة التي ستُولد في تخزين السحابة.

جرب تحويل JPG إلى PDF عبر الإنترنت (تطبيق مجاني)

إذا كنت ترغب في استكشاف هذه الوظيفة دون الحاجة إلى البرمجة، جرب تطبيق الويب المجاني PDF to JPG Converter. يتيح لك تصدير PDF كصورة JPEG على الفور في متصفحك، مدعومًا بنفس GroupDocs.Conversion Cloud API.

محول pdf إلى jpg

موارد مفيدة

استنتاج

في الختام، يوفر تحويل PDF إلى JPG باستخدام GroupDocs.Conversion Cloud SDK لـ .NET حلاً فعالًا وموثوقًا للمطورين والشركات. سواء كنت تقوم ببناء نظام إدارة مستندات آلي أو تبحث عن تحويل ملفات PDF إلى JPG لمشاركة أسهل، أو أرشفة، أو إنشاء معاينات، فإن هذه الواجهة البرمجية تجعل العملية سلسة.

الأسئلة المتكررة (FAQs)

Q. هل يمكنني تحويل ملفات PDF متعددة إلى صور دفعة واحدة؟

  • أ. نعم. واجهة برمجة التطبيقات تدعم تحويل دفعات من PDF إلى JPG، مما يسمح لك بمعالجة عدة ملفات PDF في وقت واحد.

س. ما جودة صور JPG المحوّلة؟

  • A. يضمن SDK مخرجات عالية الدقة، مع الحفاظ على وضوح النص، والرسوم البيانية المتجهة، ودقة الألوان عند تصدير PDF إلى تنسيق الصورة.

س. هل يتطلب الأمر برامج إضافية مثل أدوبي أكروبات؟

  • A. لا. واجهة برمجة التطبيقات REST لـ .NET تعمل بالكامل في السحابة - لا تحتاج إلى تثبيت محلي أو برنامج تابع لجهة خارجية.

مقالات ذات صلة

نوصي بشدة بزيارة المقالات التالية لمعرفة المزيد عن: