IRONSOFTWAREHOME

Java PDF do pliku graficznego

Curtis Chau
Curtis Chau
Updated: 29 czerwca 2026

Konwertuj dokumenty PDF na formaty obrazów, takie jak JPEG, PNG lub TIFF w Java za pomocą metody toBufferedImages z IronPDF. Załaduj plik PDF, wywołaj toBufferedImages, aby uzyskać listę obiektów BufferedImage, a następnie zapisz każdy obraz na dysku za pomocą ImageIO. Cała konwersja zajmuje mniej niż dziesięć wierszy działającego kodu Java.

Szybki start: Konwersja plików PDF na obrazy w Javie
  1. Dodaj zależność IronPDF do swojego projektu Maven:
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>
Text
  1. Załaduj dokument PDF:
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/load-pdf.java
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));
Java
  1. Konwersja na obrazy i zapis:
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-and-save.java
List<BufferedImage> images = pdf.toBufferedImages();
for (int i = 0; i < images.size(); i++) {
    ImageIO.write(images.get(i), "PNG", new File("page_" + i + ".png"));
}
Java

Czym jest konwersja plików PDF na obrazy i dlaczego jest potrzebna?

Konwersja PDF na obraz przekształca każdą stronę dokumentu PDF w samodzielny plik obrazu (JPEG, PNG lub TIFF), który można wyświetlać, osadzać lub przetwarzać bez przeglądarki PDF. Standardowe biblioteki Java nie zapewniają wbudowanego mechanizmu do tego, co sprawia, że jest to stały punkt bólu dla programistów potrzebujących podglądów dokumentów, generatorów miniatur lub przewodów archiwizacyjnych.

Częste zastosowania obejmują generowanie podglądów miniatur dla systemów zarządzania dokumentami, produkowanie zrzutów ekranowych poziomu strony dla aplikacji internetowych oraz wyodrębnianie treści wizualnych na potrzeby raportów lub prezentacji. IronPDF zajmuje się całą wewnętrzną złożonością renderowania, więc kod aplikacji pozostaje krótki, a wynik jest pikselowo dokładny, niezależnie od czcionek, grafiki wektorowej czy pól formularzy w źródłowym PDF. Dla operacji odwrotnej polegającej na umieszczaniu obrazów w pliku PDF, zobacz przewodnik zamiany obrazu na PDF.

Czym jest IronPDF for Java i w jaki sposób może pomóc?

IronPDF for Java to biblioteka do tworzenia, czytania i edytowania plików PDF w projektach opartych na Maven. Programiści używają jej do generowania PDF z HTML, modyfikowania istniejących dokumentów i wyodrębniania treści bez zainstalowanego Adobe Acrobat lub jakiejkolwiek przeglądarki PDF na serwerze.

Biblioteka obsługuje niestandardowe nagłówki i stopki, podpisy cyfrowe, tworzenie formularzy, ochronę hasłem oraz renderowanie wielowątkowe. Funkcja PDF-to-image udostępnia czyste API przez dwa przeciążenia toBufferedImages: jedno, które konwertuje każdą stronę z domyślnymi ustawieniami, i drugie, które akceptuje obiekt ToImageOptions i PageSelection, aby kontrolować rozdzielczość i zakres stron. Dla kompletnego przeglądu funkcji odwiedź dokumentację IronPDF for Java. Dla pełnego odniesienia API zobacz Java API reference.

Poza podstawową konwersją, IronPDF obsługuje renderowanie HTML do PDF, własne znaki wodne, tła i warstwy pierwszego planu oraz tworzenie formularzy. Biblioteka wysyła także artefakty Maven w repozytorium Sonatype Maven Central, więc zarządzanie zależnościami przebiega zgodnie z standardowymi przepływami pracy Maven lub Gradle.

Jakie warunki wstępne muszę spełnić przed rozpoczęciem pracy?

Przed rozpoczęciem potwierdź, że następujące rzeczy są na miejscu:

  1. Zainstalowana Java z ustawioną ścieżką w zmiennych środowiskowych. Zobacz oficjalny przewodnik instalacji Java.
  2. Zainstalowane IDE dla Java; Zarówno Eclipse, jak i IntelliJ działają dobrze. Pobierz Eclipse lub IntelliJ IDEA.
  3. Zintegrowany Maven z IDE. Zobacz ten samouczek instalacji Maven dla IntelliJ.
  4. Skonfigurowane klucze licencyjne przed wdrożeniem do środowiska produkcyjnego.

Jak zainstalować IronPDF for Java?

Kiedy wszystkie wymagania wstępne są spełnione, instalacja to pojedyncza deklaracja zależności Maven. Dla szczegółowych kroków konfiguracji zobacz dokumentację rozpoczęcia pracy.

Otwórz JetBrains IntelliJ IDEA i utwórz nowy projekt Maven.

Okno dialogowe New Project w IntelliJ IDEA z wybranym Maven i skonfigurowanym SDK Java 16 do instalacji IronPDF

Utwórz nowy projekt Maven

Pojawi się nowe okno. Wpisz nazwę projektu i kliknij Zakończ.

Okno dialogowe New Project w IntelliJ IDEA pokazujące pole wprowadzania nazwy projektu i folder Desktop jako lokalizację projektu

Nazwa nowego projektu

Po kliknięciu Zakończ nowy projekt otworzy się z domyślnie wyświetlanym pom.xml. Dodaj następujące zależności do tego pliku. Opcjonalna pozycja SLF4J tłumi szum logowania podczas rozwoju; usun to, jesli twoj projekt juz zawiera system logowania.

IntelliJ IDEA pokazujący pusty plik pom.xml Maven z ustawieniami kompilatora Java 10, gotowy do dodania zależności IronPDF

Nowy Projekt: domyslny pom.xml

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/pom-dependencies.xml
<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.9.1</version>
    </dependency>
    <!-- Optional: SLF4J logging - remove if your project already uses a logging framework -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.36</version>
    </dependency>
</dependencies>
XML

Gdy zależności zostaną dodane do pom.xml, w prawym górnym rogu edytora pojawi się ikona synchronizacji Maven.

Plik pom.xml Maven w IntelliJ IDEA z podświetlonymi blokami zależności IronPDF i SLF4J oraz widoczną ikoną synchronizacji Maven

Dodano zaleznosci Maven

Kliknij ikone synchronizacji, aby pobrac plik JAR IronPDF. Czas pobierania zalezy od predkosci polaczenia, zazwyczaj ponizej dwoch minut. Po instalacji, odwiedz Java API reference, aby zobaczyc wszystkie dostepne metody i opcje konfiguracji. Dla celow wdrozeniowych w chmurze, IronPDF posiada przetestowane przewodniki dla AWS, Azure i Google Cloud.

Jak przekonwertować pliki PDF na obrazy za pomocą IronPDF?

Wywołanie toBufferedImages na obiekcie PdfDocument generuje List<BufferedImage>, gdzie każdy element odpowiada jednej stronie PDF w rosnącej kolejności numeru strony. Nastepnie wynik moze byc zapisany na dysku, przekazany do linii przetwarzania obrazow lub zwrocony bezposrednio do odpowiedzi sieciowej.

IronPDF takze konwertuje URL-i oraz lancuchy HTML do PDFa dynamicznie, mozliwe jest wiec uchwycenie dowolnej strony internetowej lub wyrenderowanego dokumentu HTML jako obrazy w jednej linii przetwarzania bez osobnego kroku renderowania.

Jak przekonwertować istniejący dokument PDF na obrazy?

toBufferedImages przyjmuje opcjonalny argument ToImageOptions do kontrolowania wymiarów wyjścia oraz argument PageSelection do celowania w określone strony. W przypadku braku argumentow, wszystkie strony sa konwertowane w ich naturalnej rozdzielczosci.

Poniższy przykład konwertuje wszystkie strony PDF na pliki PNG, używając ToImageOptions do ograniczania każdego wyjściowego obrazu do 800x500 pikseli:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-pdf-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Load the PDF document from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages to BufferedImage objects with the configured dimensions
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());

        // Write each page image to the assets/images folder (create the folder first)
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}
Java

Obrazy wyjściowe są zapisywane do assets/images/ z numerycznymi nazwami plików zaczynając od 1. Stwórz ten folder przed uruchomieniem programu, ponieważ ImageIO.write nie tworzy brakujących katalogów. Wywołania setImageMaxHeight i setImageMaxWidth ustawiają górne granice dla każdego wymiaru; IronPDF zachowuje oryginalne proporcje i nie rozciaga obrazu.

Porady: Aby zapisać w formacie JPEG zamiast PNG, zmień ciąg formatu w ImageIO.write z "PNG" na "JPEG" i zaktualizuj odpowiednio rozszerzenie pliku.
Eksplorator plików Windows przedstawiający 11 ponumerowanych plików obrazów PNG w folderze assets/images po konwersji PDF na obraz

PDF to Images Output - 11 plikow PNG, po jednym na strone

Dla wiecej przykladow konwersji odwiedz strone przykladow rastrowania PDF.

Jak moge przekonwertowac URL do obrazow przy uzyciu IronPDF?

PdfDocument.renderUrlAsPdf pobiera URL, renderuje go za pomocą wbudowanego silnika Chromium i zwraca PdfDocument, który można natychmiast przekazać do toBufferedImages. To czyni to prostym, aby uchwycic dowolna publicznie dostepna strone jako serie obrazow.

Przyklad ponizej renderuje strone produktu Amazon do PDF, a nastepnie zapisuje kazda wynikowa strone jako plik PNG:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-url-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Render a URL to a PDF document using the Chromium rendering engine
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com");

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages and write to disk
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}
Java
Eksplorator plików Windows przedstawiający 5 ponumerowanych plików PNG w folderze assets/images po konwersji adresu URL na obrazy przy użyciu IronPDF

URL to Images Output - 5 plikow PNG

Dla stron wymagajacych uwierzytelniania lub ciasteczek sesji przed renderowaniem, przeczytaj przewodnik logowan do stron internetowych.

Zwróć uwagę: Silnik renderujący Chromium, który napędza renderUrlAsPdf, stosuje tę samą obsługę CSS i JavaScript co nowoczesna przeglądarka desktopowa. Strony polegajace na JavaScript po stronie klienta do ladowania zawartosci beda renderowane poprawnie, wlaczajac aplikacje jednkartkowe.

Jak przekonwertować określone strony na obrazy?

PageSelection udostępnia kilka metod fabrycznych do celowania w podzbiór stron, a nie w cały dokument. To jest przydatne, gdy tylko strona tytulowa, sekcja streszczenia lub znany zakres stron musi zostac wyekstrahowany.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/page-selection.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class PageSelectionExample {
    public static void main(String[] args) throws IOException {
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert only the first page (page index is zero-based)
        List<BufferedImage> coverPage = pdf.toBufferedImages(options, PageSelection.singlePage(0));
        ImageIO.write(coverPage.get(0), "PNG", new File("cover.png"));

        // Convert pages 2 through 5 (zero-based indices 1 through 4)
        List<BufferedImage> excerpt = pdf.toBufferedImages(options, PageSelection.pageRange(1, 4));
        for (int i = 0; i < excerpt.size(); i++) {
            ImageIO.write(excerpt.get(i), "PNG", new File("excerpt_" + (i + 1) + ".png"));
        }
    }
}
Java

PageSelection.singlePage(0) celuje tylko w pierwszą stronę, co jest przydatne do generowania miniatury okładki. PageSelection.pageRange(1, 4) wyodrębnia strony od drugiej do piątej przy użyciu indeksów zaczynających się od zera. Oba zwracają List<BufferedImage>, więc wzorzec pętli jest identyczny niezależnie od liczby wybranych stron.

Ważne: Indeksy stron w PageSelection zaczynają się od zera: pierwsza strona to 0, druga to 1 i tak dalej. Przekazanie indeksu poza zakresem wyrzuca IndexOutOfBoundsException w czasie wykonania.

Jakie sa nastepne kroki konwersji PDF do obrazow w Java?

Ten przewodnik omowil trzy typowe wzorce: konwersje wszystkich stron istniejacego pliku PDF, przechwycenie URL jako zestaw obrazow stron oraz wyodrebnienie określonego zakresu stron. IronPDF obsługuje kontrolę rozdzielczości i wybór formatu poprzez ToImageOptions i ImageIO, utrzymując kod wywołujący krótki i przewidywalny.

Aby kontynuowac budowanie z IronPDF dla Java, zbadz te powiazane zasoby:

IronPDF dla Java jest darmowe do rozwoju. Licencja jest wymagana do wdrozenia komercyjnego. Rozpocznij bezplatna wersje probna lub zobacz opcje licencjonowania, aby zobaczyc, jaki plan pasuje do twojego projektu.

Gotowy, aby zobaczyć, co jeszcze potrafi IronPDF? Sprawdz pelna Strone z tutorialami IronPDF dla Java.

Często Zadawane Pytania

Jak przekonwertować plik PDF do obrazów PNG w Javie?

Załaduj PDF używając PdfDocument.fromFile(), wywołaj toBufferedImages() i uzyskaj listę obiektów BufferedImage reprezentujących każdą stronę, a następnie użyj ImageIO.write(), aby zapisać każdy obraz jako plik PNG.

Jakie formaty obrazów są obsługiwane przy konwertowaniu stron PDF?

Metoda toBufferedImages firmy IronPDF zwraca obiekty BufferedImage. Możesz je zapisać w każdym formacie obsługiwanym przez klasę ImageIO Java, w tym PNG, JPEG i TIFF.

Czy mogę przekonwertować tylko konkretne strony PDF na obrazy?

Tak. Przekaż argument PageSelection do toBufferedImages. Użyj PageSelection.singlePage(0), aby przekonwertować jedną stronę lub PageSelection.pageRange(1, 4), aby przekonwertować zakres. Indeksy stron są zeropodstawowe.

Jakie są typowe zastosowania konwersji PDF na obrazy w Java?

Typowe zastosowania to generowanie miniatur podglądowych dla systemów zarządzania dokumentami, tworzenie zrzutów ekranowych poziomu strony dla aplikacji internetowych, ekstrakcja treści wizualnej do prezentacji i archiwizacja dokumentów jako pliki obrazów dla systemów, które nie obsługują renderowania PDF.

Jak dodać IronPDF do mojego projektu Maven?

Dodaj poniższą zależność w bloku <dependencies> swojego pom.xml: <dependency><groupId>com.ironsoftware</groupId><artifactId>ironpdf</artifactId><version>2024.9.1</version></dependency>

Czy mogę bezpośrednio konwertować URL na pliki obrazów?

Tak. Wywołaj PdfDocument.renderUrlAsPdf(url), aby wyrenderować stronę przy użyciu wbudowanego silnika Chromium, a następnie przekazuj wynikowy PdfDocument do toBufferedImages, aby uzyskać listę obrazów stron.

Jak kontrolować rozdzielczość wyjściowego obrazu?

Utwórz instancję ToImageOptions, wywołaj setImageMaxHeight() i setImageMaxWidth(), aby ustawić maksymalne wymiary, a następnie przekaż to jako pierwszy argument do toBufferedImages. IronPDF zachowuje proporcje i nie rozciąga obrazu.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Wersja:2026.6właśnie wydany

Odbierz swój BEZPŁATNY

30-dniowy klucz próbny natychmiast.

bullet_checkedNie wymaga karty kredytowej ani tworzenia konta
test_punktorówTestuj w produkcji
bez znaków wodnych
kalendarz_punktorów30 dni w pełni
funkcjonalny produkt
wsparcie_punktorów24/5 wsparcie techniczne
w trakcie okresu próbnego
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka Java Maven dla PDF
Zainstaluj za pomocą Maven

Wersja: 2026.6

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2026.6.1</version>
</dependency>
https://central.sonatype.com/artifact/com.ironsoftware/ironpdf/2026.6.1
lub
Plik JAR PDF Java
Pobierz JAR

Wersja: 2026.6

Pobierz teraz

Ręcznie zainstaluj w swoim projekcie

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta