Java’da Conholdate.Total Kullanarak PDF’yi PNG’ye Dönüştürmek İçin Tam Çalışan Örnek

Bu örnek, Java’da Conholdate.Total’ın dönüşüm API’si kullanılarak PDF’yi PNG’ye nasıl dönüştüreceğinizi gösterir.

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);
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Java Kodunda PDF’yi PNG’ye Dönüştürmeyi Anlamak

Aşağıdaki noktalar örnek programın iş akışını ayrıntılandırır:

1. PDF’yi Yükle ve Sayfa Sayısını Belirle - Converter sınıfı, kaynak PDF’ye işaret eden bir InputStream ile örneklenir. getPageCount() çağrısı, tüm belgeyi belleğe yüklemeden toplam sayfa sayısını alır.

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

2. Paralel İşleme İçin Bir Thread Havuzu Oluşturun - Kullanılabilir işlemcilerin sayısına göre boyutlandırılmış bir ExecutorService, dönüşüm görevlerini eşzamanlı olarak çalıştırarak genel verimliliği artırır.

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

3. Sayfa‑Spesifik Dönüştürme Seçeneklerini Yapılandırın - Her görev içinde yeni bir Converter örneği oluşturulur (iş parçacığı güvenliğini sağlayarak). PngConvertOptions hedef sayfayı, çözünürlüğü ve PNG kalitesini ayarlamanıza olanak tanır.

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

4. Dönüşümü Gerçekleştir ve PNG Dosyasını Yaz - convert yöntemi, sayfa numarasını içeren biçimlendirilmiş bir dosya adı kullanarak çıktı PNG’sini yazar.

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

5. Tamamlamayı Senkronize Et ve Temizle - Ana iş parçacığı, tüm future’ların tamamlanmasını bekler, ardından yürütücüyü kapatır ve geçen süreyi yazdırır. Bu desen, program çıkmadan önce her sayfanın işlendiğini garanti eder.

Daha ayrıntılı API detayları için, Conholdate.Total Java API Referansı adresini inceleyin.

Ortamı Hazırlama

Conholdate.Total Maven deposunu ve bağımlılığını pom.xml dosyanıza ekleyin:

<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>

En son SDK paketini resmi indirme sayfasından indirin. Kütüphane Java 8 veya daha yenisini gerektirir ve herhangi bir standart JVM’de çalışır.

Dönüştürme Ayarlarını Yapılandırma

Örnek kod, ayarlayabileceğiniz üç ana seçeneği gösterir:

• Page Number - options.setPageNumber(pageNumber); render edilecek belirli sayfayı seçer.
• Resolution - options.setResolution(150); DPI’yi kontrol eder. Daha yüksek değerler ayrıntıyı artırır ancak bellek kullanımını yükseltir.
• Quality - options.setQuality(90); PNG sıkıştırmasını (0‑100) ayarlar. Dosya boyutu ve görsel doğruluk arasında denge kurmak için bu değeri ayarlayın.

Ek kontrol gerekiyorsa, API referansı setColorMode ve setBackgroundColor gibi diğer özellikleri listeler.

PDF’den PNG’ye Verimli Dönüşüm İçin En İyi Uygulamalar

• Sayfaları Tek Tek Akıta Al - Tüm PDF’i belleğe yüklemekten kaçınmak için her sayfayı bir InputStream‘den işleyin.
• Sabit‑Boyutlu İş Parçacığı Havuzu Kullan - Havuz boyutunu Runtime.getRuntime().availableProcessors() ile eşleştirerek iş parçacığı çarpışmalarını önler ve CPU kullanımını maksimize eder.
• Orta Düzey DPI Ayarla - Çoğu önizleme senaryosu için 150 DPI, kalite ve performans arasında iyi bir denge sağlar.
• Dönüştürücü Örneklerini Az Kullan - Her iş parçacığı için yeni bir Converter oluşturmak, iş parçacığı güvenliğini sağlar; tek bir örneği paylaşmak yarış koşullarına yol açabilir.
• Çalışma Süresini Ölç - Örnek, geçen saniyeleri yazdırır; bu verileri belirli iş yükünüz için çözünürlük veya iş parçacığı sayısını ince ayarlamak için kullanın.

Sonuç

Java’da PDF’yi PNG’ye dönüştürmek rutin bir işlem olmakla birlikte performans açısından hassastır. Conholdate.Total for Java ile sayfa‑sayfa akış, çok iş parçacıklı yürütme ve ayrıntılı görüntü seçeneklerini yöneten tam özellikli bir SDK elde edersiniz. Yukarıdaki örnek, ölçeklenebilir bir PDF‑to‑PNG dönüşüm aracını nasıl oluşturacağınızı, çözünürlük ve kaliteyi nasıl yapılandıracağınızı ve bellek kullanımını düşük tutacağınızı gösterir. Üretim kullanımı için geçerli bir lisans almayı unutmayın; geçici bir lisans isteyebilirsiniz https://purchase.conholdate.com/temporary-license/ adresinden ve fiyatlandırma seçeneklerini https://purchase.conholdate.com/pricing/total/family/ adresinde inceleyebilirsiniz. Kodu entegre edin, ayarları ihtiyaçlarınıza göre ayarlayın ve herhangi bir PDF belgesinden hızlı, güvenilir görüntü önizlemeleri sunun.

Sık Sorulan Sorular

• Java’da harici araçlar kullanmadan PDF’yi PNG’ye nasıl dönüştürürüm?
  SDK, dönüşümü tamamen kod içinde gerçekleştirir, bu yüzden herhangi bir üçüncü taraf komut satırı aracına ihtiyacınız yoktur. Sadece Maven bağımlılığını ekleyin ve gösterildiği gibi Converter sınıfını kullanın.

• Java’da PDF’ten PNG’ye dönüştürme yardımcı programından ne tür bir performans bekleyebilirim?
  Sayfaları paralel işleyerek ve orta seviyede bir DPI (ör. 150) kullanarak, örnek tipik olarak 50 sayfalık bir PDF’i modern bir CPU’da birkaç saniyeden daha kısa sürede dönüştürür. Programın yazdırdığı geçen süreyi ölçerek kendi dosyalarınızı benchmark edebilirsiniz.

• Birçok yüksek çözünürlüklü görüntü içeren PDF’leri belleği tükenmeden dönüştürebilir miyim?
  Evet. Kod her sayfayı ayrı ayrı akıtarak ve dönüşümden sonra InputStream‘i serbest bırakarak yığın ayak izini küçük tutar. Bellek sıkıntısı yaşarsanız çözünürlüğü ayarlayın veya daha az iş parçacığı çalıştırın.

• PNG çıktısını daha da özelleştirmek, örneğin arka plan rengini değiştirmek mümkün mü?
  Ek seçenekler PngConvertOptions içinde mevcuttur. setBackgroundColor ve setColorMode gibi özellikler için API referansına bakın.

İlgili Makaleler

• JPG’yi Java’da PNG’ye Dönüştür
• CDR’yi Java’da PNG’ye Dönüştür
• PDF’yi Java’da Gri Tonlamaya Dönüştür