Jak przekonwertować PDF do pliku obrazu w Node.js

Jak zainstalować IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Zainstaluj pakiet Node.js IronPDF z npm, aby konwertować PDF na PNG, JPG, GIF, BMP i inne formaty obrazów.

Przed konwersją PDF do obrazów na produkcji, skonfiguruj klucz licencyjny. Pakiet wymaga również zainstalowania IronPDF Engine na Twoim systemie — to binarium obsługuje wszystkie operacje renderowania PDF i musi być obecne, aby konwersja mogła działać.

Jak przekonwertować plik PDF na obraz?

Metoda rasterizeToImageFiles odczytuje dokument PDF i zapisuje jeden plik obrazu na stronę w podanej ścieżce wyjściowej. W przypadku jednostronicowych plików PDF generuje dokładnie jeden obraz. W przypadku PDF-ów wielostronicowych automatycznie dodawany jest sufiks numeru strony do każdej nazwy pliku.

Przykład poniżej ładuje< a href="próbkę" target="_blank">https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-file.pdf">próbkę PDF z Learning Container i konwertuje ją na plik PNG.

Próbka pliku PDF otwarta w przeglądarce. Pobierz ten plik i inne testowe PDF-y z Learning Container.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Load the PDF and convert it to a PNG image.
// The output path determines the format — change .png to .jpg for JPEG output.
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
}).catch((error) => {
    console.error("Error converting PDF to image:", error);
});

PdfDocument.fromFile ładuje plik PDF i zwraca obietnicę (Promise) rozwiązującą się w obiekt PdfDocument. Funkcja zwrotna .then odbiera przetworzony dokument i wywołuje rasterizeToImageFiles z ścieżką docelową. Rozszerzenie pliku w ścieżce — w tym przypadku .png — informuje IronPDF, jaki format ma zostać wygenerowany. Blok .catch obsługuje wszelkie błędy odczytu lub konwersji.

PNG wygenerowany z powyższego przykładu PDF. IronPDF konwertuje dokument w trzech liniach kodu.

Aby uzyskać bardziej szczegółowe przykłady opcji tej metody, zobacz przykłady kodu PDF do obrazów.

Jak konwertować PDF do formatu JPEG?

Wybór formatu jest automatyczny: rozszerzenie przekazane do rasterizeToImageFiles określa format wyjściowy. Aby uzyskać JPEG zamiast PNG, zmień rozszerzenie w ścieżce docelowej:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Gdy nie można kontrolować nazwy pliku wyjściowego — na przykład w automatycznych potokach z ustalonymi schematami nazewnictwa — należy przekazać wartość ImageType w obiekcie opcji, aby zastąpić wykrywanie oparte na rozszerzeniu:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// ImageType.JPG forces JPEG output regardless of the file extension.
const options = {
    type: ImageType.JPG,
    dpi: 300
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/output.png", options);
    return pdf;
});

Właściwość type w obiekcie opcji ma pierwszeństwo przed rozszerzeniem nazwy pliku. W powyższym przykładzie rasterizeToImageFiles generuje plik JPEG, mimo że ścieżka docelowa kończy się na .png. Ten sam wzór dotyczy wyjść GIF i BMP.

Jak konwertować wielostronicowy PDF na obrazy?

W przypadku dokumentów składających się z więcej niż jednej strony, rasterizeToImageFiles tworzy jeden obraz na stronę. IronPDF dodaje indeks strony zaczynający od zera do każdej nazwy pliku wyjściowego, utrzymując porządek bez konieczności pisania dodatkowego kodu.

Próbka dwustronicowego PDF-a. IronPDF tworzy jeden plik obrazu na stronę podczas konwersji.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Each page of the PDF becomes a separate image file.
// Output filenames: multipage-pdf-page_1.png, multipage-pdf-page_2.png, etc.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

Dwa pliki PNG wytworzone z dwustronicowego PDF-a. IronPDF nazywa każdy plik wyjściowy numerem strony.

To automatyczne dzielenie na strony działa ze wszystkimi obsługiwanymi formatami obrazów. Połącz to z opcją fromPages w następnej sekcji, aby przekonwertować tylko określone strony z dużych dokumentów. Aby pracować w przeciwnym kierunku, przykład obraz do PDF pokazuje, jak łączyć wiele plików obrazów w jeden dokument PDF.

Jak konwertować tylko konkretne strony?

Właściwość fromPages w obiekcie opcji przyjmuje tablicę indeksów stron zaczynających się od zera. Tylko określone strony są rastrowane; wszystkie inne zostają pominięte. To przydatne, gdy pracujesz z dużymi PDF-ami, gdzie potrzebna jest tylko podgrupa stron — na przykład wydobycie stron tytułowych i początkowych dla sekcji dla podglądu dokumentu. Jeśli przed konwersją konieczne jest przetworzenie poszczególnych stron, dokumentacja API Node.js dla PdfDocument opisuje dodatkowe operacje na poziomie strony.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert only pages 1, 4, 6, and 9 (zero-indexed: 0, 3, 5, 8) to BMP.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],
    dpi: 150
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles(
        "./images/multipage-selective-pdf/multipage-pdf-page.bmp",
        options
    );
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

IronPDF zrasteryzował tylko cztery strony określone w tablicy fromPages. Pozostałe strony nie zostały przetworzone.

Indeksy stron w fromPages są liczone od zera, więc [0, 3, 5, 8] odnosi się do pierwszej, czwartej, szóstej i dziewiątej strony. Wartość DPI równą 150 balansuje jakość wyjścia z rozmiarem pliku — odpowiednia do przypadku użycia w archiwizacji lub podglądzie. Selektoryczna konwersja jest kompatybilna z wszystkimi obsługiwanymi typami obrazów.

Jakie są kolejne kroki konwersji PDF na obraz?

Metoda rasterizeToImageFiles firmy IronPDF obsługuje wybór formatu, dzielenie na wiele stron oraz selektywną konwersję stron w spójnym interfejsie API. Obiekt opcji jest jedynym punktem rozszerzania dla nadpisywania formatu, kontroli DPI i filtrowania stron.

Ponadto dokumentacja API IronPDF for Node.js zawiera wszystkie parametry dostępne w klasach rasterizeToImageFiles i PdfDocument. Przykład kodu PDF to Images pokazuje rasterizeToImageFiles użyty z dodatkową konfiguracją. Aby pracować w przeciwnym kierunku, zobacz konwersję obrazów na pliki PDF lub konwersję wieloklatkowych plików TIFF na PDF.

Rozpocznij darmową wersję próbną IronPDF dla Node.js, aby przetestować konwersję PDF na obraz w swoim własnym projekcie. Zobacz opcje licencyjne, aby znaleźć plan pasujący do twojego zespołu.

Gotowy, aby zobaczyć, co jeszcze potrafi IronPDF? Przejrzyj pełen samouczek dla Node.js tutaj: HTML do PDF w Node.js