Wie man eine PDF in eine Bilddatei in Node.js konvertiert

Wie wandle ich ein PDF in eine Bilddatei in Node.js um

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Node.js wandelt PDF-Seiten mit einem einzigen Methodenaufruf in Bilder um. Die rasterizeToImageFiles Methode erzeugt PNG-, JPG-, GIF-, BMP- und andere Formate aus einer beliebigen PDF -- einseitig oder mehrseitig -- mit direkter Kontrolle über Ausgaberesolution und Seitenauswahl.

Die Methode erkennt automatisch das Ausgabeformat aus der von Ihnen bereitgestellten Dateierweiterung, sodass ein Wechsel zwischen Formaten keine Konfigurationsänderungen erfordert. Für Umgebungen, in denen die Erweiterung nicht geändert werden kann, überschreibt ein expliziter ImageType Enum-Wert die erweiterungsbasierte Erkennung. Die IronPDF Node.js-Dokumentation behandelt das vollständige Spektrum unterstützter Eingabequellen, einschließlich Dateipfade, Byte-Puffer und HTML-Zeichenfolgen, die vor der Rasterung in PDF umgewandelt werden.

Kurzanleitung: PDF in PNG umwandeln

  1. Installieren Sie IronPDF: npm install @ironsoftware/ironpdf
  2. Importieren Sie PdfDocument aus dem Paket
  3. Laden Sie Ihr PDF mit PdfDocument.fromFile()
  4. Rufen Sie rasterizeToImageFiles() mit dem Ausgabepfad auf
:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/quickstart.js

Wie installiere ich IronPDF for Node.js?

 npm i @ironsoftware/ironpdf

Installieren Sie das Node.js-Paket von IronPDF über npm, um PDFs in PNG, JPG, GIF, BMP und andere Bildformate zu konvertieren.

Bevor Sie PDFs in der Produktion in Bilder umwandeln, konfigurieren Sie Ihren Lizenzschlüssel. Das Paket erfordert außerdem, dass die IronPDF-Engine auf Ihrem System installiert ist — dieses Binary führt alle PDF-Darstellungsoperationen durch und muss vorhanden sein, damit die Konvertierung funktioniert.

Was sind die Systemvoraussetzungen?

Node.js 12 oder neuer ist erforderlich. Das IronPDF-Engine-Binary wird beim ersten Laden des Pakets automatisch heruntergeladen, aber Sie können es auch manuell installieren, wenn Ihre Bereitstellungsumgebung ausgehenden Netzwerkzugriff einschränkt. Das @ironsoftware/ironpdf Paket ist im npm-Registry verfügbar und erfordert keinen nativen Modulerstellungsschritt, was CI-Pipelines einfach hält.

Hinweis:Ein Lizenzschlüssel ist während der Entwicklung nicht erforderlich. Im nicht lizenzierten Modus wird ein markiertes Wasserzeichen ausgegeben. Wasserzeichen werden entfernt, sobald ein gültiger Schlüssel konfiguriert ist.

Wie konvertiere ich ein PDF in ein Bild?

Die rasterizeToImageFiles Methode liest ein PDF-Dokument und schreibt eine Bilddatei pro Seite an den von Ihnen angegebenen Ausgabepfad. Bei einseitigen PDFs erzeugt sie genau ein Bild. Bei mehrseitigen PDFs wird automatisch ein Seitenzahlensuffix an jeden Dateinamen angehängt.

Das untenstehende Beispiel lädt ein Beispiel-PDF von Learning Container und konvertiert es in eine PNG-Datei.

PDF-Viewer zeigt ein einsitiges Lorem Ipsum-Beispieldokument, das als Eingabe vor der PDF-zu-Bild-Konvertierung verwendet wird Die Beispiel-PDF-Datei in einem Betrachter geöffnet. Laden Sie diese Datei und andere Test-PDFs von Learning Container herunter.

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

PdfDocument.fromFile lädt das PDF und gibt ein Promise zurück, das zu einem PdfDocument Objekt auflöst. Der .then Rückruf erhält das aufgelöste Dokument und ruft rasterizeToImageFiles mit dem Zielpfad auf. Die Dateierweiterung im Pfad — .png hier — teilt IronPDF mit, welches Format erstellt werden soll. Der .catch Block behandelt alle Lese- oder Konvertierungsfehler.

Konvertierte PNG-Ausgabedatei zeigt den Inhalt des Lorem Ipsum-Dokuments als PNG-Bild dargestellt Das aus dem obigen Beispiel-PDF erstellte PNG. IronPDF konvertiert das Dokument mit drei Codezeilen.

Für detailliertere Beispiele zu den Optionen dieser Methode siehe die PDF zu Bildern Codebeispielseite.

Wie wandelt man ein PDF in das JPEG-Format um?

Die Formatauswahl ist automatisch: Welche Erweiterung Sie an rasterizeToImageFiles übergeben, bestimmt das Ausgabeformat. Um ein JPEG statt eines PNG zu erzeugen, ändern Sie die Erweiterung im Zielpfad:

//: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");

Wenn der Ausgabedateiname nicht kontrolliert werden kann — zum Beispiel in automatisierten Pipelines mit festen Namenskonventionen — übergeben Sie einen ImageType Wert im Optionsobjekt, um die erweiterungsbasierte Erkennung zu überschreiben:

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

Die type Eigenschaft im Optionsobjekt hat Vorrang vor der Dateierweiterung. Im obigen Beispiel erzeugt rasterizeToImageFiles eine JPEG-Datei, obwohl der Zielpfad mit .png endet. Das gleiche Muster gilt für GIF- und BMP-Ausgaben.

Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

Die dpi Eigenschaft im Optionsobjekt steuert die Pixeldichte der rasterisierten Ausgabe. Höhere Werte erzeugen größere Dateien mit mehr Details; niedrigere Werte reduzieren die Dateigröße auf Kosten der Schärfe.

TippsDas Setzen von dpi: 300 erzeugt Bilder in Druckqualität, die für hochauflösende Drucke oder Archivierung geeignet sind. Für Bildschirmanzeigen oder Thumbnail-Erzeugung reduziert dpi: 96 die Dateigröße, während ausreichende Klarheit für die Webnutzung beibehalten wird.

Ein DPI von 150 ist ein vernünftiger Standard für die meisten Archivierungs- oder Vorschauszenarien – die Ausgabe ist ausreichend klar für das Lesen auf dem Bildschirm und die Dateigrößen bleiben handhabbar. Für Inhalte, die gedruckt oder nach der Konvertierung OCR-verarbeitet werden sollen, sind 300 DPI oder mehr vorzuziehen.

Icon Quote related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen
Icon Quote related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen
Icon Quote related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones related to Wie beeinflussen DPI-Einstellungen die Ausgabequalität?

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Wie wandelt man ein mehrseitiges PDF in Bilder um?

Für Dokumente mit mehr als einer Seite erstellt rasterizeToImageFiles ein Bild pro Seite. IronPDF hängt einen nullbasierten Seitenindex an jeden Ausgabedateinamen an, sodass die Ausgabe organisiert bleibt, ohne dass zusätzlicher Code erforderlich ist.

Ein zweiseitiges PDF-Dokument in einem Viewer geöffnet, zeigt zwei Seiten Beispielinhalt vor der Bildkonvertierung Ein zweiseitiges Beispiel-PDF. IronPDF erstellt während der Konvertierung eine Bilddatei pro Seite.

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

Zwei PNG-Ausgabedateien — multipage-pdf-page_1.png und multipage-pdf-page_2.png — erstellt aus dem oben genannten zweiseitigen PDF Die zwei PNG-Dateien, die aus dem zweiseitigen PDF erstellt wurden. IronPDF benennt jede Ausgabedatei mit der Seitennummer.

Dieses automatische Seitenteilungsverhalten funktioniert mit allen unterstützten Bildformaten. Kombinieren Sie es mit der fromPages Option im nächsten Abschnitt, um nur bestimmte Seiten aus großen Dokumenten zu konvertieren. Um in die entgegengesetzte Richtung zu arbeiten, zeigt das Beispiel Bild zu PDF, wie mehrere Bilddateien zu einem einzigen PDF-Dokument zusammengefügt werden.

Wie sind Ausgabedateinamen strukturiert?

Das Dateimuster verwendet eine einsbasierte Seitennummer, die vor der Dateierweiterung angehängt wird. Wenn der Ausgabepfad ./images/report-page.png ist, erzeugt ein dreiseitiges PDF report-page_1.png, report-page_2.png und report-page_3.png. Das Ausgabeverzeichnis muss existieren, bevor rasterizeToImageFiles aufgerufen wird — die Methode erstellt fehlende Verzeichnisse nicht automatisch.

WichtigErstellen Sie das Ausgabeverzeichnis, bevor Sie rasterizeToImageFiles aufrufen. Die Methode löst einen Fehler aus, wenn das Zielverzeichnis nicht existiert. Verwenden Sie Node.js's fs.mkdirSync('./images/output', { recursive: true }), um es im Voraus zu erstellen.

Wie konvertiere ich nur bestimmte Seiten?

Die fromPages Eigenschaft im Optionsobjekt akzeptiert ein Array von nullbasierten Seitenindizes. Nur die angegebenen Seiten werden gerastert; alle anderen werden übersprungen. Dies ist nützlich beim Arbeiten mit großen PDFs, wo nur eine Teilmenge von Seiten benötigt wird — beispielsweise das Extrahieren von Titel- und Kapitelnanfangsseiten für eine Dokumentenvorschau. Wenn Sie mit einzelnen Seiten arbeiten müssen, bevor Sie sie konvertieren, dokumentiert die Node.js-API-Referenz für PdfDocument zusätzliche seitenbezogene Operationen.

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

Vier BMP-Ausgabedateien mit den Bezeichnungen multipage-pdf-page_1, page_4, page_7 und page_9, erstellt aus einem großen PDF IronPDF rasterisierte nur die vier im fromPages Array angegebenen Seiten. Die anderen Seiten wurden nicht verarbeitet.

Seitenindizes in fromPages sind nullbasiert, daher zielt [0, 3, 5, 8] auf die erste, vierte, sechste und neunte Seite ab. Der DPI-Wert von 150 balanciert die Ausgabequalität gegenüber der Dateigröße – geeignet für Archivierungs- oder Vorschauanwendungsfälle. Selective Konvertierung ist kompatibel mit allen unterstützten Bildtypen.

Hinweis:Laden Sie das Beispiel-PDF mit Bildern aus dem obigen Beispiel von Learning Container herunter.

Was ist der Unterschied zwischen null- und einsbasierten Seitennummern?

fromPages verwendet nullbasierte Indizierung, die dem Standard-Array-Konventionen von JavaScript entspricht. Seite 1 des Dokuments entspricht dem Index 0, Seite 2 dem Index 1 usw. Dies unterscheidet sich von den einsbasierten Seitennummern, die in PDF-Betrachtern angezeigt werden. Beim Übersetzen von Seitenzahlen des Viewers in fromPages Indizes, ziehen Sie von jeder Seitenzahl eins ab.

TippsUm die letzte Seite eines PDF zu konvertieren, ohne die Gesamtseitenzahl im Voraus zu wissen, lesen Sie die Seitenzahl mit pdf.pageCount() aus der PdfDocument-API und verwenden Sie [pdf.pageCount() - 1] als fromPages Wert.

Was sind die nächsten Schritte zur PDF-zu-Bild-Konvertierung?

Die rasterizeToImageFiles Methode von IronPDF behandelt die Formatauswahl, Aufteilung in mehrere Seiten und selektive Seitenkonvertierung in einer konsistenten API. Das Optionsobjekt ist der einzige Erweiterungspunkt für Formatüberschreibungen, DPI-Steuerung und Seitenfilterung.

Um weiterzugehen, dokumentiert die IronPDF Node.js API-Referenz alle verfügbaren Parameter für rasterizeToImageFiles und die PdfDocument Klasse. Das PDF zu Bilder Codebeispiel zeigt rasterizeToImageFiles, verwendet mit zusätzlicher Konfiguration. Um in die entgegengesetzte Richtung zu arbeiten, siehe Bilder zu PDF-Dateien konvertieren oder mehrseitige TIFF-Dateien zu PDF konvertieren.

Starten Sie Ihre kostenlose Testversion von IronPDF for Node.js, um die PDF-zu-Bild-Konvertierung in Ihrem eigenen Projekt zu testen. Sehen Sie sich die Lizenzierungsmöglichkeiten an, um den Plan zu finden, der zu Ihrem Team passt.

Bereit zu sehen, was IronPDF sonst noch kann? Sehen Sie sich das vollständige Node.js-Tutorial hier an: HTML zu PDF in Node.js

Häufig gestellte Fragen

Wie konvertiere ich in Node.js ein PDF in ein Bild?

Verwenden Sie die rasterizeToImageFiles-Methode von IronPDF. Installieren Sie das Paket mit npm install @ironsoftware/ironpdf, laden Sie Ihr PDF mit PdfDocument.fromFile() und rufen Sie dann rasterizeToImageFiles() mit dem Ausgabeweg auf. Die Dateiendung bestimmt das Ausgabeformat automatisch.

Welche Bildformate unterstützt rasterizeToImageFiles?

IronPDF unterstützt PNG, JPG, GIF und BMP als Ausgabeformate. Das Format wird aus der Dateiendung im Ausgabeweg erkannt. Um dies zu überschreiben, übergeben Sie einen ImageType-Enumwert im Optionsobjekt: Zum Beispiel erzwingt { type: ImageType.JPG } JPEG-Ausgabe, unabhängig von der Dateierweiterung.

Wie konvertiere ich nur bestimmte Seiten eines PDFs in Bilder?

Übergeben Sie ein fromPages-Array im Optionsobjekt. Das Array akzeptiert nullbasierte Seitenindizes, sodass fromPages: [0, 2, 4] die erste, dritte und fünfte Seite konvertiert. Seiten, die nicht im Array aufgeführt sind, werden übersprungen.

Welche DPI sollte ich für die Konvertierung von PDF zu Bild verwenden?

Setzen Sie die dpi-Eigenschaft im Optionsobjekt. Verwenden Sie dpi: 96 für Bildschirmdarstellung und Thumbnails, dpi: 150 für Archivierungs- und Vorschauzwecke und dpi: 300 für Druckausgabe in hoher Qualität oder Inhalte, die nach der Konvertierung von OCR verarbeitet werden.

Was sind die Installationsanforderungen für IronPDF in Node.js?

Node.js 12 oder neuer ist erforderlich. Installieren Sie das Paket mit npm install @ironsoftware/ironpdf. Die IronPDF-Engine-Binärdatei wird beim ersten Gebrauch automatisch heruntergeladen und verarbeitet alle PDF-Renderings. Für den Produktionseinsatz wird ein Lizenzschlüssel benötigt, um Wasserzeichen aus der Ausgabe zu entfernen.

Wie sind die Ausgabedateinamen für mehrseitige PDFs strukturiert?

IronPDF fügt eine einbasierte Seitennummer vor der Dateiendung hinzu. Wenn der Ausgabeweg report-page.png ist, produziert ein dreiseitiges PDF report-page_1.png, report-page_2.png, und report-page_3.png. Das Ausgabeverzeichnis muss vor dem Aufruf der Methode existieren.

Ist die Konvertierung von PDF zu Bild in Node.js asynchron?

Ja. Sowohl PdfDocument.fromFile() als auch rasterizeToImageFiles() geben Promises zurück. Ketten Sie .then() für den Erfolgsweg und .catch(), um Konvertierungsfehler zu behandeln. Sie können auch die async/await-Syntax mit diesen Methoden verwenden.

Darrius Serrant
Full-Stack-Software-Ingenieur (WebOps)

Darrius Serrant hat einen Bachelor-Abschluss in Informatik von der University of Miami und arbeitet als Full-Stack-WebOps-Marketing-Ingenieur bei Iron Software. Seit seiner Jugend vom Programmieren angezogen, sah er die Informatik als sowohl mysteriös als auch zugänglich, was es zum perfekten Medium für Kreativität und Problemlösung ...

Weiterlesen
Bereit anzufangen?
Version: 2026.6 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis?
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.