در اکوسیستم دیجیتال مدرن، نیاز به تبدیل PDF اسناد به JPG تصاویر بیشتر از هر زمان دیگری رایج است. چه به دنبال صادرات PDF به JPEG باشید، چه ایجاد پیش‌نمایش‌های سند یا پردازش PDF به فرمت‌های تصویری برای برنامه‌های وب، اتوماسیون می‌تواند زمان ارزشمندی را صرفه‌جویی کند.

در این راهنما، ما قصد داریم بررسی کنیم که چگونه می‌توانیم یک برنامه تبدیل PDF به تصویر JPG قوی بر اساس API مقیاس‌پذیر REST توسعه دهیم.

چرا PDF را به JPG یا JPEG تبدیل کنیم؟

  • Preview generation – نمایش صفحات PDF به عنوان تصاویر در برنامه‌های وب یا سیستم‌های محتوا.
  • اشتراک‌گذاری آسان – تصاویر JPG در تمامی دستگاه‌ها سازگار هستند.
  • High fidelity – رنگ‌ها، چیدمان و گرافیک‌های برداری را حفظ کنید.
  • Automation-ready – مناسب برای پردازش اسناد در سمت سرور.
  • مقیاس‌پذیری – به‌طور آسان چندین فایل PDF را به JPG به صورت عمده تبدیل کنید.

API تبدیل PDF

SDK ابری GroupDocs.Conversion Cloud برای .NET یک راه حل مبتنی بر Cloud برای تبدیل PDF به JPG و بسیاری از فرمت‌های دیگر را ارائه می‌دهد. این SDK از ده‌ها نوع سند و تصویر پشتیبانی می‌کند و به شما یک روش آسان برای صادرات 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) با استفاده از API REST .NET دنبال کنید:

مرحله ۱. - یک نمونه از کلاس‌های Configuration، ConvertApi و FileApi ایجاد کنید.

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

مرحله ۲. - بارگذاری فایل PDF به فضای ذخیره سازی ابری.

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

مرحله ۳. - تعریف ConvertSettings برای تبدیل PDF به JPG.

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

مرحله ۴. - از روش 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 ایجاد کنید و Client ID و Client Secret را به عنوان آرگومان‌ها پاس کنید. 
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"))
{
    // بارگزاری فایل PDF ورودی به فضای ذخیره‌سازی ابری.
    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 صادر کنید

اگر رویکرد مبتنی بر اسکریپت را ترجیح می‌دهید، می‌توانید با استفاده از GroupDocs.Conversion Cloud REST API و cURL، PDF را به JPG تبدیل کنید.

چرا از 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 در مرورگر خود صادر کنید، با قدرت API GroupDocs.Conversion Cloud.

تبدیل پی‌دی‌اف به جی‌پی‌جی

منابع مفید

نتیجه گیری

در نتیجه، تبدیل PDF به JPG با استفاده از GroupDocs.Conversion Cloud SDK برای .NET یک راه حل کارآمد و قابل اعتماد برای توسعه دهندگان و کسب و کارها ارائه می‌دهد. آیا شما در حال ساخت یک سیستم مدیریت اسناد خودکار هستید یا به دنبال تبدیل فایل‌های PDF به JPG برای اشتراک‌گذاری آسان‌تر، بایگانی، یا تولید پیش‌نمایش هستید، این API فرآیند را بدون مشکل می‌کند.

سوالات متداول (FAQs)

س. آیا می‌توانم چندین فایل PDF را به طور همزمان به تصاویر تبدیل کنم؟

  • A. بله. این API از تبدیل دسته‌ای PDF به JPG پشتیبانی می‌کند و به شما این امکان را می‌دهد که چندین PDF را به طور همزمان پردازش کنید.

س. کیفیت تصاویر JPG تبدیل شده چگونه است؟

  • A. SDK خروجی با fidelity بالا را تضمین می‌کند و وضوح متن، گرافیک وکتور و دقت رنگ را در هنگام صادرات PDF به فرمت تصویر حفظ می‌کند.

س. آیا نرم‌افزار اضافی مانند Adobe Acrobat مورد نیاز است؟

  • A. نه. API REST .NET به طور کامل در Cloud اجرا می‌شود—هیچ نصب محلی یا نرم‌افزار شخص‌سومی لازم نیست.

مقالات مرتبط

ما به شدت توصیه می‌کنیم که مقالات زیر را برای یادگیری بیشتر مطالعه کنید: