مثال کامل کارآمد برای تبدیل PDF به PNG در جاوا با استفاده از Conholdate.Total

این مثال نشان می‌دهد که چگونه می‌توان PDF را به PNG در Java با استفاده از API تبدیل Conholdate.Total تبدیل کرد.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PngConvertOptions;

import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.*;

public class PdfToPngDemo {
    private static final String INPUT_PDF = "input.pdf";
    private static final String OUTPUT_PATTERN = "output_page_%d.png";

public static void main(String[] args) throws Exception {
        long start = System.nanoTime();

// Determine page count without loading whole document into memory
        int totalPages;
        try (InputStream is = new FileInputStream(INPUT_PDF)) {
            Converter tempConverter = new Converter(is);
            totalPages = tempConverter.getPageCount();
        }

// Thread pool sized to available processors
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        List<Future<?>> tasks = new ArrayList<>();

for (int page = 1; page <= totalPages; page++) {
            final int pageNumber = page;
            tasks.add(executor.submit(() -> {
                // Each thread creates its own Converter instance – ensures thread safety
                try (InputStream pdfStream = new FileInputStream(INPUT_PDF)) {
                    Converter converter = new Converter(pdfStream);

PngConvertOptions options = new PngConvertOptions();
                    options.setPageNumber(pageNumber);          // convert single page
                    options.setResolution(150);                 // memory‑friendly DPI
                    options.setQuality(90);                     // PNG compression quality (0‑100)

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
                    converter.convert(outputPath, options);
                } catch (Exception e) {
                    throw new RuntimeException("Failed to convert page " + pageNumber, e);
                }
            }));
        }

// Wait for all conversions to finish
        for (Future<?> f : tasks) {
            f.get(); // re‑throws any exception from the task
        }

executor.shutdown();

long end = System.nanoTime();
        System.out.printf("PDF to PNG conversion completed in %.2f seconds.%n",
                (end - start) / 1_000_000_000.0);
    }
}

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌روز کنید تا با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

درک تبدیل PDF به PNG در کد Java

نکات زیر جریان کار برنامه نمونه را تجزیه و تحلیل می‌کنند:

1. PDF را بارگذاری کنید و تعداد صفحات را تعیین کنید - کلاس Converter با یک InputStream که به PDF منبع اشاره می‌کند، نمونه‌سازی می‌شود. فراخوانی getPageCount() تعداد کل صفحات را بدون بارگذاری کل سند در حافظه بازیابی می‌کند.

try (InputStream is = new FileInputStream(INPUT_PDF)) {
    Converter tempConverter = new Converter(is);
    totalPages = tempConverter.getPageCount();
}

2. ایجاد یک استخر رشته برای پردازش موازی - یک ExecutorService با اندازه‌ای برابر با تعداد پردازنده‌های موجود، وظایف تبدیل را به‌صورت همزمان اجرا می‌کند و از این طریق بازده کلی را بهبود می‌بخشد.

ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());

3. پیکربندی گزینه‌های تبدیل مخصوص صفحه - در هر کار یک نمونه جدید Converter ایجاد می‌شود (برای اطمینان از ایمنی رشته). PngConvertOptions به شما امکان می‌دهد صفحه هدف، وضوح و کیفیت PNG را تنظیم کنید.

PngConvertOptions options = new PngConvertOptions();
options.setPageNumber(pageNumber);
options.setResolution(150);
options.setQuality(90);

4. اجرای تبدیل و نوشتن فایل PNG - متد convert خروجی PNG را با استفاده از یک نام فایل قالب‌بندی‌شده که شامل شماره صفحه است می‌نویسد.

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
converter.convert(outputPath, options);

5. همگام‌سازی تکمیل و پاک‌سازی - رشته اصلی منتظر می‌ماند تا تمام futureها تمام شوند، سپس executor را خاموش می‌کند و زمان سپری‌شده را چاپ می‌کند. این الگو تضمین می‌کند که هر صفحه قبل از خروج برنامه پردازش شود.

برای جزئیات عمیق‌تر API، به Conholdate.Total مرجع API جاوا مراجعه کنید.

آماده‌سازی محیط

مخزن Maven Conholdate.Total و وابستگی آن را به pom.xml خود اضافه کنید:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

آخرین بسته SDK را از صفحه دانلود رسمی دریافت کنید. این کتابخانه به Java 8 یا بالاتر نیاز دارد و بر روی هر JVM استانداردی اجرا می‌شود.

پیکربندی تنظیمات تبدیل

کد نمونه سه گزینه کلیدی را که می‌توانید تنظیم کنید، نشان می‌دهد:

• شماره صفحه - options.setPageNumber(pageNumber); صفحه خاصی را برای رندر انتخاب می‌کند.
• وضوح - options.setResolution(150); DPI را کنترل می‌کند. مقادیر بالاتر جزئیات را بهبود می‌بخشند اما مصرف حافظه را افزایش می‌دهند.
• کیفیت - options.setQuality(90); فشرده‌سازی PNG (۰‑۱۰۰) را تنظیم می‌کند. این مقدار را برای تعادل بین حجم فایل و دقت بصری تنظیم کنید.

اگر به کنترل بیشتری نیاز دارید، مرجع API سایر ویژگی‌ها مانند setColorMode و setBackgroundColor را فهرست می‌کند.

بهترین روش‌ها برای تبدیل کارآمد PDF به PNG

• صفحات را به‌صورت جریان‌دار پردازش کنید - هر صفحه را از یک InputStream پردازش کنید تا از بارگذاری کل PDF در حافظه جلوگیری شود.
• از یک استخر نخ ثابت‑اندازه استفاده کنید - تنظیم اندازه استخر برابر با Runtime.getRuntime().availableProcessors() از پرش نخ‌ها جلوگیری می‌کند و در عین حال استفاده حداکثری از CPU را فراهم می‌سازد.
• یک DPI متوسط تنظیم کنید - برای بیشتر سناریوهای پیش‌نمایش، 150 DPI تعادل خوبی بین کیفیت و عملکرد ارائه می‌دهد.
• نمونه‌های Converter را به‌ندرت دوباره استفاده کنید - ایجاد یک Converter جدید برای هر نخ، ایمنی نخ را تضمین می‌کند؛ به‌اشتراک‌گذاری یک نمونه می‌تواند منجر به شرایط رقابتی شود.
• زمان اجرا را اندازه‌گیری کنید - نمونه، ثانیه‌های سپری‌شده را چاپ می‌کند؛ از این داده‌ها برای تنظیم دقیق وضوح یا تعداد نخ‌ها برای بار کاری خاص خود استفاده کنید.

نتیجه‌گیری

تبدیل PDF به PNG در جاوا یک عملیات روتین اما حساس به عملکرد است. با Conholdate.Total for Java، یک SDK کامل دریافت می‌کنید که پخش صفحه به صفحه، اجرا به صورت چندنخی و گزینه‌های دقیق تصویر را مدیریت می‌کند. مثال بالا نشان می‌دهد چگونه یک ابزار مقیاس‌پذیر برای تبدیل PDF به PNG بسازید، وضوح و کیفیت را پیکربندی کنید و مصرف حافظه را کم نگه دارید. به یاد داشته باشید برای استفاده در تولید یک لایسنس معتبر دریافت کنید؛ می‌توانید یک لایسنس موقت را در https://purchase.conholdate.com/temporary-license/ درخواست کنید و گزینه‌های قیمت‌گذاری را در https://purchase.conholdate.com/pricing/total/family/ بررسی کنید. کد را یکپارچه کنید، تنظیمات را بر حسب نیاز خود تنظیم کنید و پیش‌نمایش‌های سریع و قابل اعتماد تصویر را از هر سند PDF ارائه دهید.

سوالات متداول

• چگونه PDF را به PNG در جاوا بدون ابزارهای خارجی تبدیل کنم؟
  SDK تبدیل را به طور کامل در کد انجام می‌دهد، بنابراین نیازی به ابزارهای خط فرمان شخص ثالث ندارید. فقط وابستگی Maven را اضافه کنید و از کلاس Converter همان‌طور که نشان داده شده استفاده کنید.

• از ابزار تبدیل PDF به PNG در جاوا چه عملکردی می‌توانم انتظار داشته باشم؟
  با پردازش صفحات به صورت موازی و استفاده از DPI متوسط (مثلاً 150)، این نمونه معمولاً یک PDF ۵۰‑صفحه‌ای را در کمتر از چند ثانیه بر روی یک CPU مدرن تبدیل می‌کند. می‌توانید با اندازه‌گیری زمان سپری شده که توسط برنامه چاپ می‌شود، عملکرد فایل‌های خود را بسنجید.

• آیا می‌توانم PDFهایی که حاوی تعداد زیادی تصویر با وضوح بالا هستند را بدون تمام شدن حافظه تبدیل کنم؟
  بله. کد هر صفحه را به‌صورت جداگانه استریم می‌کند و پس از تبدیل InputStream را آزاد می‌سازد، که باعث می‌شود مصرف حافظه کم بماند. اگر با فشار حافظه مواجه شدید، وضوح را تنظیم کنید یا تعداد رشته‌ها را کاهش دهید.

• آیا امکان سفارشی‌سازی بیشتر خروجی PNG، مانند تغییر رنگ پس‌زمینه، وجود دارد؟
  گزینه‌های اضافی در PngConvertOptions موجود است. برای ویژگی‌هایی مانند setBackgroundColor و setColorMode به مرجع API مراجعه کنید.

مقالات مرتبط

• تبدیل JPG به PNG در جاوا
• تبدیل CDR به PNG در جاوا
• تبدیل PDF به مقیاس خاکستری در جاوا