Jak przekonwertować PDF do pliku obrazu w Node.js

Jak zainstalować IronPDF for Node.js?

npm i @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 przekazanej ścieżce wyjściowej. Dla jednostronicowych PDF produkuje 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

PdfDocument.fromFile ładuje PDF i zwraca Obietnicę, która rozwiązuje się do obiektu PdfDocument. Wywołanie zwrotne .then odbiera rozwiązany dokument i wywołuje rasterizeToImageFiles z ścieżką docelową. Rozszerzenie pliku w ścieżce — tutaj .png — mówi IronPDF, jaki format wyprodukować. 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: każde rozszerzenie, które przekażesz 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 zautomatyzowanych potokach z ustalonymi schematami nazw — przekaż wartość ImageType w obiekcie opcji, aby nadpisać wykrywanie oparte na rozszerzeniu:

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js

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

Jak ustawienia DPI wpływają na jakość wyjścia?

Właściwość dpi w obiekcie opcji kontroluje zagęszczenie pikseli wyjściu rastrowanego. Wyższe wartości dają większe pliki z większą szczegółowością; niższe wartości zmniejszają rozmiar pliku kosztem ostrości.

PoradyUstawienie dpi: 300 produkuje obrazy nadające się do druku w wysokiej rozdzielczości, odpowiednie do drukowania wysokiej jakości lub archiwizacji. Dla wyświetlania na ekranie lub generowania miniatur, dpi: 96 zmniejsza rozmiar pliku, jednocześnie utrzymując wystarczającą czystość dla użytku online.

DPI wynoszące 150 to rozsądna wartość domyślna dla większości scenariuszy archiwizacji lub podglądu — wyjście jest wystarczająco wyraźne do czytania na ekranie, a rozmiary plików pozostają na akceptowalnym poziomie. Do treści, które mają być drukowane lub poddawane OCR po konwersji, preferowane jest 300 DPI lub więcej.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak konwertować wielostronicowy PDF na obrazy?

Dla dokumentów z więcej niż jedną stroną, 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

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 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 akceptuje tablicę z indeksami stron zaczynającymi 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. Gdy musisz pracować z indywidualnymi stronami przed ich konwersją, dokumentacja API Node.js dla PdfDocument dokumentuje dodatkowe operacje na poziomie stron.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js

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

Indeksy stron w fromPages są oparte na zerze, więc [0, 3, 5, 8] celuje w pierwszą, czwartą, szóstą i dziewiątą stronę. 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 IronPDF obsługuje wybór formatu, podział na wiele stron i wybiórczą konwersję stron w spójne API. Obiekt opcji jest jedynym punktem rozszerzania dla nadpisywania formatu, kontroli DPI i filtrowania stron.

Aby iść dalej, dokumentacja API Node.js IronPDF dokumentuje wszystkie parametry dostępne na rasterizeToImageFiles i klasie PdfDocument. Przykład kodu PDF to Images pokazuje użycie rasterizeToImageFiles z dodatkowymi ustawieniami konfiguracji. 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