Node.js で PDF を画像ファイルに変換する方法

Node.jsでPDFを画像ファイルに変換する方法

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

IronPDF for Node.jsは単一のメソッドコールでPDFページを画像に変換します。 rasterizeToImageFilesメソッドは、ページ選択と出力解像度を直に制御して、任意のPDF(単一ページまたは複数ページ)からPNG、JPG、GIF、BMPなどの形式を生成します。

このメソッドは、指定されたファイル拡張子から出力形式を自動的に検出するため、形式を切り替える際に設定変更は必要ありません。 拡張機能を変更できない環境では、明示的なImageType列挙値が拡張ベースの検出をオーバーライドします。 IronPDF Node.jsドキュメントには、ファイルパス、バイトバッファ、ラスタライズ前のPDFに変換されたHTML文字列を含む、サポートされている入力ソースの全範囲が記載されています。

Quickstart: PDFをPNGに変換as-heading:2()

  1. IronPDFをインストールする: npm install @ironsoftware/ironpdf
  2. パッケージからPdfDocumentをインポートする
  3. PdfDocument.fromFile()を使用してPDFを読み込む
  4. 出力パスでrasterizeToImageFiles()を呼び出す
:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/quickstart.js

どのようにIronPDF for Node.jsをインストールしますか?

 npm i @ironsoftware/ironpdf

IronPDF for Node.jsパッケージをnpmからインストールして、PDFをPNG、JPG、GIF、BMP、その他の画像形式に変換します。

本番環境でPDFを画像に変換する前に、ライセンスキーを構成してください。 このパッケージには、システムにIronPDFエンジンをインストールする必要もあります。このバイナリはすべてのPDFレンダリング操作を処理し、変換が機能するためには存在している必要があります。

システム要件は何ですか?

Node.js 12以上が必要です。 IronPDF Engineバイナリは、パッケージが初めて読み込まれる際に自動的にダウンロードされますが、展開環境で外部ネットワークアクセスが制限されている場合は、手動でインストールすることも可能です。 @ironsoftware/ironpdfパッケージはnpmレジストリで利用可能で、ネイティブモジュールのコンパイルステップがないため、CIパイプラインがシンプルに保たれます。

ご注意開発中はライセンスキーは必要ありません。 未認証モードで透かし付き出力が生成されます。 有効なキーが設定されると、透かしが削除されます。

PDFを画像に変換するには?

rasterizeToImageFilesメソッドはPDFドキュメントを読み込み、指定した出力パスにページごとの画像ファイルを書き込みます。単ページのPDFの場合、正確に1つの画像が生成されます。 複数ページのPDFの場合、各ファイル名にページ番号の接尾辞が自動的に追加されます。

以下の例では、Learning ContainerのサンプルPDFを読み込み、PNGファイルに変換します。

PDFビューアで1ページのLorem Ipsumサンプルドキュメントが表示されており、画像変換前の入力として使用されています ビューアで開かれたサンプルPDFファイル Learning Containerからこのファイルおよび他のテストPDFをダウンロードしてください。

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

PdfDocumentオブジェクトに解決するPromiseを返します。 rasterizeToImageFilesを呼び出して出力先パスを指定します。 ここでのパスのファイル拡張子— .png —はIronPDFにどのフォーマットを生成するかを伝えます。 .catchブロックは読み取りまたは変換エラーを処理します。

Lorem IpsumドキュメントコンテンツがPNG画像としてレンダリングされた変換後のPNG出力ファイル 上記のサンプルPDFから生成されたPNG IronPDFは3行のコードでドキュメントを変換します。

このメソッドのオプションをより詳しく示す例については、PDFから画像へのコード例ページを参照してください。

PDFをJPEG形式に変換する方法

フォーマットの選択は自動的に行われます。rasterizeToImageFilesに渡す拡張子が出力フォーマットを決定します。 PNGの代わりにJPEGを生成するには、宛先パスの拡張子を変更します:

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

出力ファイル名が固定された命名規則の自動化パイプラインなどで制御できない場合、オプションオブジェクトで拡張子ベースの検出を上書きするImageType値を渡します。

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

オプションオブジェクト内のtypeプロパティがファイル名の拡張子よりも優先されます。 上記の例では、.pngで終わるにもかかわらず、JPEGファイルを生成します。 このパターンはGIFやBMPの出力にも適用されます。

DPI設定は出力品質にどのように影響しますか?

オプションオブジェクト内のdpiプロパティはラスター化された出力のピクセル密度を制御します。 値が高いほど、詳細が多くファイルが大きくなります; 値が低いとシャープネスが犠牲になりますが、ファイルサイズが小さくなります。

ヒントdpi: 300を設定すると、高解像度印刷やアーカイブに適した印刷品質の画像が生成されます。 スクリーン表示やサムネイル生成には、dpi: 96がファイルサイズを削減しながら、ウェブ用に十分な明瞭性を保ちます。

150 DPIはほとんどのアーカイブやプレビューシナリオに適したデフォルトで、出力は十分に鮮明であり、ファイルサイズも扱いやすい範囲です。 変換後に印刷する、またはOCR処理の対象となるコンテンツは、300 DPI以上が推奨されます。

Icon Quote related to DPI設定は出力品質にどのように影響しますか?

私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。

Milan Jovanovic related to DPI設定は出力品質にどのように影響しますか?

Milan Jovanovic

Microsoft MVP

ケーススタディを見る
Icon Quote related to DPI設定は出力品質にどのように影響しますか?

IronOCRのおかげで私たちは年間$40,000を手作業の処理から節約し、生産性を向上させ、高影響のタスクにリソースを充てることができます。非常にお勧めします。

Brent Matzelle related to DPI設定は出力品質にどのように影響しますか?

Brent Matzelle

最高技術責任者, OPYN

ケーススタディを見る
Icon Quote related to DPI設定は出力品質にどのように影響しますか?

IronSuiteは私たちの業務において重要な役割を果たしています。これらは、フロアプランの作成や在庫管理の改善を含め、ビジネス全体の効率を向上させるツールです。

David Jones related to DPI設定は出力品質にどのように影響しますか?

David Jones

リードソフトウェアエンジニア、Agorus Build

ケーススタディを見る

複数ページのPDFを画像に変換するにはどうすればよいですか?

複数ページの文書の場合、rasterizeToImageFilesはページごとに1つの画像を生成します。 IronPDFは、ゼロベースのページインデックスを各出力ファイル名に追加し、追加のコードなしで出力を整理します。

ビューアで開いた2ページのPDFドキュメントで、画像変換前に2ページのサンプルコンテンツが表示されています 2ページのサンプルPDF。 IronPDFは、変換中にページごとに1つの画像ファイルを作成します。

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

上記の2ページのPDFから作成された2つのPNG出力ファイル — multipage-pdf-page_1.png と multipage-pdf-page_2.png 2ページのPDFから作成された2つのPNGファイル。 IronPDFは、各出力ファイルをページ番号で命名します。

この自動ページ分割動作は、サポートされている全ての画像形式で機能します。 次のセクションのfromPagesオプションと組み合わせることで、大きな文書から特定のページのみを変換できます。 別の方向で作業するには、画像をPDFに変換する例をご覧ください。複数の画像ファイルを単一のPDF文書に結合する方法が示されています。

出力ファイル名の構造はどうなっていますか?

ファイル名パターンは、ファイル拡張子の前に1ベースのページ番号を追加します。 出力パスがreport-page_3.pngを生成します。 メソッドrasterizeToImageFiles呼び出しの前に出力ディレクトリが存在していなければなりません — メソッドは不足しているディレクトリを自動的に作成しません。

[[n: (出力ディレクトリをrasterizeToImageFiles呼び出しの前に作成してください。 ターゲットディレクトリが存在しない場合、メソッドはエラーをスローします。Node.jsのfs.mkdirSync('./images/output', { recursive: true })を使用して事前に作成してください。)]]

特定のページだけを変換するにはどうすればよいですか?

オプションオブジェクト内のfromPagesプロパティは、ゼロベースのページインデックスの配列を受け入れます。 指定されたページのみがラスタライズされます; 他のページはスキップされます。 これは、大きなPDFで一部のページのみ必要な場合に役立ちます - たとえば、ドキュメントプレビュー用の表紙やセクション開始ページを抽出するなど。 変換前に個々のページを扱う必要がある場合は、Node.js APIリファレンスのPdfDocumentで追加のページレベル操作が記録されています。

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

大きなPDFから生成されたmultipage-pdf-page_1、page_4、page_7、page_9とラベル付けされた4つのBMP出力ファイル IronPDFはfromPages配列で指定された4ページのみをラスター化しました。 他のページは処理されませんでした。

[0, 3, 5, 8]は1、4、6、9ページを対象とします。 150のDPI値は、出力品質とファイルサイズのバランスをとっています - アーカイブまたはプレビューのユースケースに適しています。 選択的変換は、サポートされているすべての画像タイプと互換性があります。

ご注意上記の例で使用した画像付きサンプルPDFをLearning Containerからダウンロードしてください。

ゼロベースとワンベースのページ番号の違いは何ですか?

fromPagesはJavaScriptの標準配列規約と一致するゼロベースインデックスを使用します。 文書のページ1はインデックス1に対応します。 これは、PDFビューアに表示されるワンベースのページ番号とは異なります。 ビューワーページ番号をfromPagesインデックスに変換する場合、各ページ番号から1を引いてください。

ヒント総ページ数を事前に知らずにPDFの最後のページを変換するには、PdfDocument API[pdf.pageCount() - 1]を使用してください。

PDFから画像への変換の次のステップは何ですか?

IronPDFのrasterizeToImageFilesメソッドは、フォーマット選択、複数ページのスプリッティング、選択的なページ変換を一貫したAPIで処理します。 オプションオブジェクトは、フォーマットのオーバーライド、DPI制御、ページフィルタリングのための単一の拡張ポイントです。

さらに進むために、IronPDF Node.js APIリファレンスには、PdfDocumentクラスで利用可能なすべてのパラメータが記録されています。 PDFから画像へのコード例では、追加設定とともにrasterizeToImageFilesが使用されている様子が示されています。 反対方向に作業するには、画像をPDFファイルに変換するまたはマルチフレームTIFFファイルをPDFに変換するを参照してください。

IronPDF for Node.jsの無料トライアルを始めて、独自プロジェクトでのPDFから画像への変換を試すことができます。 ライセンスオプションを表示することで、チームに適したプランを見つけてください。

IronPDFの他の機能をご覧になりたいですか? 完全なNode.jsチュートリアルはこちらをご覧ください:HTMLからPDFへの変換

よくある質問

Node.jsでPDFを画像に変換するには?

IronPDFのrasterizeToImageFilesメソッドを使用します。npm install @ironsoftware/ironpdfでパッケージをインストールし、PdfDocument.fromFile()を使ってPDFをロードし、出力パスを指定してrasterizeToImageFiles()を呼び出します。ファイル拡張子が出力フォーマットを自動的に決定します。

rasterizeToImageFilesはどの画像フォーマットをサポートしていますか?

IronPDFはPNG、JPG、GIF、およびBMPの出力をサポートしています。フォーマットは出力パスのファイル拡張子から検出されます。これを上書きするには、オプションオブジェクト内でImageType列挙型の値を渡します。たとえば、{ type: ImageType.JPG }と指定すると、ファイル名の拡張子に関係なくJPEG出力が強制されます。

PDFの特定のページだけを画像に変換するにはどうすればよいですか?

オプションオブジェクト内にfromPages配列を渡します。配列は0から始まるページインデックスを受け入れるため、fromPages: [0, 2, 4]の場合、最初、三番目、および五番目のページが変換されます。配列に記載されていないページはスキップされます。

PDFを画像に変換する際に使用すべきDPIは何ですか?

オプションオブジェクト内でdpiプロパティを設定します。画面表示やサムネイルにはdpi: 96を使用し、アーカイブやプレビューのユースケースにはdpi: 150を使用します。印刷品質の出力や変換後にOCRで処理されるコンテンツにはdpi: 300を使用します。

Node.js における IronPDF のインストール要件は何ですか?

Node.js 12以降が必要です。パッケージはnpm install @ironsoftware/ironpdfでインストールしてください。IronPDF Engineバイナリは初回使用時に自動でダウンロードされ、PDFのレンダリングをすべて処理します。本番環境で使用する場合は、出力から透かしを削除するためにライセンスキーを設定してください。

複数ページのPDFの出力ファイル名はどのように構成されていますか?

IronPDFは、ファイル拡張子の前に1から始まるページ番号を付け足します。出力パスがreport-page.pngの場合、3ページのPDFはreport-page_1.pngreport-page_2.pngreport-page_3.pngになります。メソッドを呼び出す前に出力ディレクトリが存在している必要があります。

Node.jsでのPDFから画像への変換は非同期ですか?

はい。両方のPdfDocument.fromFile()rasterizeToImageFiles()はPromiseを返します。成功した場合のパスには.then()をチェーンし、変換エラーを処理するには.catch()を使用します。また、これらのメソッドにはasync/await構文を使うこともできます。

Darrius Serrant
フルスタックソフトウェアエンジニア(WebOps)

Darrius Serrantは、マイアミ大学でコンピュータサイエンスの学士号を取得し、Iron SoftwareでフルスタックWebOpsマーケティングエンジニアとして働いています。若い頃からコーディングに惹かれ、コンピューティングを神秘的かつアクセス可能なものとし、創造性と問題解決のための完璧な媒体と考えていました。

Iron Softwareでは、新しいものを創造することと、複雑なコンセプトをより理解しやすくすることを楽しんでいます。Resident Developerの一人として、次世代に専門知識を共有するために、学生を教えることにも志願しました。

Darriusにとって、その仕事は価値があり、実際の影響があるため、満足感があります。

準備はできましたか?
バージョン: 2026.6 リリースされたばかり
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか?
サンプルを実行するHTML が PDF に変換されるのを確認します。