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

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

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

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

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

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

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

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

ビューアで開かれたサンプルPDFファイル Learning Containerからこのファイルおよび他のテストPDFをダウンロードしてください。

//: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 は PDF を読み込み、PdfDocument オブジェクトを解決する Promise を返します。 .then コールバックは、解決されたドキュメントを受け取り、宛先パスを引数として rasterizeToImageFiles を呼び出します。 パス内のファイル拡張子（ここでは .png）は、IronPDF に対してどの形式で出力するかを指定します。 .catch ブロックは、読み取りエラーや変換エラーを処理します。

上記のサンプル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
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;
});

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

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

複数ページにわたるドキュメントの場合、rasterizeToImageFiles を使用すると、1ページごとに1つの画像が生成されます。 IronPDFは、ゼロベースのページインデックスを各出力ファイル名に追加し、追加のコードなしで出力を整理します。

2ページのサンプルPDF。 IronPDFは、変換中にページごとに1つの画像ファイルを作成します。

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

2ページのPDFから作成された2つのPNGファイル。 IronPDFは、各出力ファイルをページ番号で命名します。

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

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

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

//: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は、fromPages配列で指定された4ページのみをラスタライズしました。 他のページは処理されませんでした。

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

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

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

さらに詳しく知りたい場合は、IronPDF Node.js API リファレンスで、rasterizeToImageFiles および PdfDocument クラスで使用可能なすべてのパラメータを確認できます。 "PDFから画像への変換"のコード例では、追加の設定とともに rasterizeToImageFiles が使用されています。 反対方向に作業するには、画像をPDFファイルに変換するまたはマルチフレームTIFFファイルをPDFに変換するを参照してください。

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

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