Volledig werkend voorbeeld voor het converteren van PDF naar PNG in Java met Conholdate.Total

Dit voorbeeld toont hoe u PDF naar PNG kunt converteren in Java met de conversie‑API van 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);
    }
}

Opmerking: Dit codevoorbeeld toont de kernfunctionaliteit. Voordat u het in uw project gebruikt, moet u ervoor zorgen dat u alle bestandspaden en configuratiewaarden bijwerkt zodat ze overeenkomen met uw werkelijke omgeving, verifieer dat alle vereiste afhankelijkheden correct zijn geïnstalleerd, en test grondig in uw ontwikkelomgeving. Als u problemen ondervindt, raadpleeg dan de officiële documentatie of neem contact op met het ondersteuningsteam voor hulp.

Begrijpen van het converteren van PDF naar PNG in Java-code

De volgende punten beschrijven de workflow van het voorbeeldprogramma:

1. Laad de PDF en bepaal het aantal pagina’s - De Converter‑klasse wordt geïnstantieerd met een InputStream die naar de bron‑PDF wijst. Het aanroepen van getPageCount() haalt het totale aantal pagina’s op zonder het volledige document in het geheugen te laden.

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

2. Maak een threadpool voor parallelle verwerking - Een ExecutorService met een grootte die overeenkomt met het aantal beschikbare processoren voert conversietaken gelijktijdig uit, waardoor de algehele doorvoersnelheid wordt verbeterd.

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

3. Configureer pagina‑specifieke conversie‑opties - Binnen elke taak wordt een nieuw Converter‑object gemaakt (wat thread‑veiligheid garandeert). PngConvertOptions stelt u in staat de doelpagina, resolutie en PNG‑kwaliteit in te stellen.

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

4. Voer de conversie uit en schrijf het PNG‑bestand - De convert‑methode schrijft de uitvoer‑PNG met een geformatteerde bestandsnaam die het paginanummer bevat.

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

5. Synchroniseer voltooiing en opruimen - De hoofdthread wacht tot alle futures zijn voltooid, schakelt vervolgens de executor uit en drukt de verstreken tijd af. Dit patroon garandeert dat elke pagina wordt verwerkt voordat het programma wordt afgesloten.

Voor meer gedetailleerde API‑informatie, raadpleeg de Conholdate.Total Java API Reference.

De omgeving gereed maken

Voeg de Conholdate.Total Maven-repository en afhankelijkheid toe aan uw 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>

Download het nieuwste SDK‑pakket van de officiële downloadpagina. De bibliotheek vereist Java 8 of hoger en draait op elke standaard JVM.

Conversie‑instellingen configureren

De voorbeeldcode toont drie belangrijke opties die u kunt afstemmen:

• Paginanummer - options.setPageNumber(pageNumber); selecteert de specifieke pagina om weer te geven.
• Resolutie - options.setResolution(150); bepaalt de DPI. Hogere waarden verbeteren de details maar verhogen het geheugenverbruik.
• Kwaliteit - options.setQuality(90); stelt de PNG-compressie in (0‑100). Pas deze waarde aan om een balans te vinden tussen bestandsgrootte en visuele nauwkeurigheid.

Als u extra controle nodig heeft, vermeldt de API‑referentie andere eigenschappen zoals setColorMode en setBackgroundColor.

Beste praktijken voor efficiënte PDF-naar-PNG-conversie

• Pagina’s Individueel Streamen - Verwerk elke pagina vanuit een InputStream om te voorkomen dat de volledige PDF in het geheugen wordt geladen.
• Gebruik een Threadpool met Vaste Grootte - Het afstemmen van de poolgrootte op Runtime.getRuntime().availableProcessors() voorkomt thread‑thrashing en maximaliseert het CPU‑gebruik.
• Stel een Gematigde DPI In - Voor de meeste preview‑scenario’s biedt 150 DPI een goede balans tussen kwaliteit en prestaties.
• Herbruik Converter‑instanties Spaarzaam - Het maken van een nieuwe Converter per thread zorgt voor thread‑veiligheid; het delen van één instantie kan race‑condities veroorzaken.
• Meet de Uitvoertijd - Het voorbeeld drukt de verstreken seconden af; gebruik deze gegevens om de resolutie of het aantal threads fijn af te stemmen op uw specifieke werklast.

Conclusie

PDF naar PNG converteren in Java is een routinematige maar prestatie‑gevoelige bewerking. Met Conholdate.Total for Java krijg je een volledig uitgeruste SDK die paginavoor‑paginastreaming, multithreaded uitvoering en fijnmazige afbeeldingsopties afhandelt. Het voorbeeld hierboven laat zien hoe je een schaalbare PDF‑naar‑PNG‑conversie‑utility bouwt, de resolutie en kwaliteit configureert en het geheugengebruik laag houdt. Vergeet niet een geldige licentie voor productiegebruik te verkrijgen; je kunt een tijdelijke licentie aanvragen op https://purchase.conholdate.com/temporary-license/ en de prijsopties bekijken op https://purchase.conholdate.com/pricing/total/family/. Integreer de code, pas de instellingen aan jouw behoeften aan, en lever snelle, betrouwbare afbeeldingsvoorbeelden van elk PDF‑document.

Veelgestelde vragen

• Hoe converteer ik PDF naar PNG in Java zonder externe tools?
  De SDK voert de conversie volledig in code uit, dus je hebt geen externe commandoregelhulpmiddelen van derden nodig. Voeg gewoon de Maven‑afhankelijkheid toe en gebruik de Converter‑klasse zoals getoond.

• Welke prestaties kan ik verwachten van het PDF‑naar‑PNG conversie‑hulpmiddel in Java?
  Door pagina’s parallel te verwerken en een gematigde DPI te gebruiken (bijv. 150), converteert het voorbeeld doorgaans een PDF van 50 pagina’s in minder dan een paar seconden op een moderne CPU. Je kunt je eigen bestanden benchmarken door de verstreken tijd te meten die door het programma wordt afgedrukt.

• Kan ik PDF’s die veel hoge‑resolutie‑afbeeldingen bevatten converteren zonder dat het geheugen opraakt?
  Ja. De code streamt elke pagina afzonderlijk en maakt de InputStream vrij na conversie, waardoor de heap‑voetafdruk klein blijft. Pas de resolutie aan of gebruik minder threads als u geheugenproblemen ondervindt.

• Is het mogelijk om de PNG‑output verder aan te passen, bijvoorbeeld door de achtergrondkleur te wijzigen?
  Extra opties zijn beschikbaar in PngConvertOptions. Raadpleeg de API‑referentie voor eigenschappen zoals setBackgroundColor en setColorMode.

Gerelateerde artikelen

• Converteer JPG naar PNG in Java
• Converteer CDR naar PNG in Java
• Converteer PDF naar Grijstinten in Java