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

PDFを画像ファイルに変換する方法

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

Node.jsで PDF ファイルを画像に変換するには、IronPDF の rasterizeToImageFiles メソッドを使用します。 この方法では、PDFをJPG、PNG、GIF、その他の形式に変換することができ、すべてのページまたは特定のページを変換するオプションがあります。 このライブラリは、変換プロセスを効率的に処理し、高画質を維持しながら、出力形式を柔軟に選択できます。

クイックスタート: PDF を画像に変換する

  1. IronPDFをインストールします: npm install @ironsoftware/ironpdf
  2. PdfDocument クラスをインポートする
  3. PdfDocument.fromFile() を使用して PDF ファイルを読み込みます。
  4. 出力パスを指定してrasterizeToImageFiles()を呼び出す 5.この方法では、ファイルの拡張子から形式を自動的に検出します。
:title=Quick PDF to PNG Conversion
import { PdfDocument } from "@ironsoftware/ironpdf";

PdfDocument.fromFile("./sample.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./output.png");
});

PDF ファイルを画像に変換するには、 IronPDF for Node.jsモジュールによって提供される rasterizeToImageFiles メソッドを使用します。 PDFをJPG、PNG、その他の画像形式に変換するために、このメソッドを設定します。 すべてのページを変換するか、特定のページを選択します。 IronPdfは変換プロセスを完全にコントロールすることができます。

PDFから画像へ変換するIronPDFをインストールするには?

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

IronPDF for Node.jsモジュールをNPMからインストールし、PDFをPNG、JPG、GIF、その他の画像タイプに変換する

PDFを画像に変換する前に、ライセンスキーを設定してください。 このライブラリは、PDFレンダリング処理を行うIronPdf Engineがシステムにインストールされている必要があります

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

プレースホルダテキストを含む1ページのサンプルPDFドキュメントを使用して作業します。 より複雑なシナリオについては、まずHTMLをPDFに変換し、その結果を画像に変換することを検討してください。

画像形式に変換する前の Lorem Ipsum テキスト文書を表示する PDF ビューア サンプルPDFファイルがPDFビューアアプリケーションで開かれている画像。 Learning Containerからテスト用にこのPDFファイルやその他をダウンロードできます。**

以下のソースコードでは、PDFファイルをPNGファイルに変換します。

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF File to a PNG File
// The operation is performed asynchronously with promises
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 を使用します。 この関数は、サンプルファイルを表す PdfDocument クラスを返します。このオブジェクトはPromiseに格納されているため、Promise が解決されたときに実行されるコールバック関数を追加します。

コールバック内では、解決されたオブジェクトに対して rasterizeToImageFiles を呼び出して、単一ページのドキュメントを画像に変換します。 引数として、翻訳先のパス(ファイル名と拡張子を含む)を指定します。 この方法は、IronPDFがPDFへの画像埋め込みを処理する方法と同様に、様々なフォーマットをサポートします。

PDF ファイルからドキュメントの内容を表示する変換された PNG 画像 上記のソースコードから生成された画像です。 IronPDFはサンプルPDFをたった3行のコードでPNGファイルに変換しました!**

Learning Containerは、テスト用にサンプルPDFファイルを提供します。 この例で使用されているサンプルPDFファイルを無料でダウンロードできます。 上記の例を、サイズや複雑さの異なる他のPDFで試してみてください。 より詳細な画像変換の例については、包括的なPDF to Imagesガイドをご覧ください。

どのような高度な画像変換オプションがありますか?

PDFをJPEG形式に変換するにはどうすればよいですか?

デフォルトでは、rasterizeToImageFiles は、宛先パスで指定されたファイルの種類に従ってドキュメントを変換します。 この自動フォーマット検出機能により、コードを変更することなく、画像フォーマットを簡単に切り替えることができます。

サンプルPDFをJPGファイルに変換するには、変換先パスのファイル拡張子を変更してください:

// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

または、ImageType オプションを指定します。 ImageType 値は、宛先パスで宣言されたイメージ ファイルの種類をオーバーライドします。 これにより、rasterizeToImageFiles は変換を実行するときにファイル名を無視するようになり、出力形式を明示的に制御できるようになります。

次の例には、ImageType を宣言する rasterizeToImageFiles の呼び出しに JSON オプション引数が含まれています。

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF to JPEG Format using ImageType.JPG
const options = {
   type: ImageType.JPG,
   dpi: 300  // High quality output
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options);
    return pdf;
});

このプログラムはJPG画像を作成します。 翻訳先のファイル名には、PNGファイルの拡張子が使用されています。 rasterizeToImageFiles は .PNG 拡張子を無視し、代わりに ImageType.JPG 値に従います。 このアプローチは、明示的な型指定が優先される他の変換操作をIronPDFがどのように扱うかに似ています。

この例は、PDFをGIFやビットマップ形式を含む他の画像形式に変換するために適応させることができます。

ヒント:このアプローチは、自動ファイル命名システムで作業するときや、異なる出力フォーマット間で一貫した命名規則を維持するときなど、ファイル名を特定のタイプに変更することが実行不可能な場合に役立ちます。

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

複数ページの文書を変換する場合は、同様に rasterizeToImageFiles メソッドを使用します。 このメソッドでは、各ページを指定されたタイプの別の画像として作成し、ファイル名にページ番号を自動的に付加します。 この機能は、画像ギャラリーを作成するときや、複数ページのドキュメントを扱うときに便利です。

画像変換処理前のサンプルコンテンツを表示する 2 ページの PDF ドキュメントがビューアで開かれています 2ページのサンプルPDFドキュメント。

次のサンプルコードブロックは、上記の2ページのPDFファイルの例から2つのPNGファイルを生成します。

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF with two pages to a set of images.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

2 ページの PDF から作成された 2 つの個別の PNG ファイル。ファイル名に自動的にページ番号が付けられていることが示されています。 2ページのPDFファイルにrasterizeToImageFilesメソッドを使用した結果。このメソッドは、元のファイルの各ページごとに画像を作成します。

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

複数ページのドキュメントから特定のページをラスタライズするには、fromPages プロパティを持つ JSON オブジェクトを使用します。 この選択的変換は、PDFから特定のページを削除する方法のように、特定のページだけが必要な大きなPDFを扱うときに便利です。

次のコード例は、この大きなサンプルファイルの最初、4番目、6番目、および9番目のページだけをビットマップに変換します。

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF containing many pages to BMP images.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],  // Select only the desired pages (0-indexed)
    dpi: 150  // Balance quality and file size
};
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);
});

4 つの PDF ページが、multipage-pdf-page_2、page_4、page_7、page_9 ファイルを示す画像に正常に変換されました IronPDF は、options 引数で指定したページに対してのみ PDF から画像への操作を実行しました。

選択的ページ変換機能は、サポートされているすべての画像形式で動作し、指定した品質設定を維持します。 より複雑なページ操作については、包括的なAPIリファレンスを参照してください。

その他のリソースはどこで見つけることができますか?

APIドキュメントはどこで見つけることができますか?

ニーズに合わせてメソッドを調整する方法の詳細については、 PdfDocument クラスとその rasterizeToImageFiles メソッドに関する API ドキュメントをお読みください。 ドキュメントは、利用可能なすべてのパラメータとオプションに関する詳細な情報を提供します。

他にどのようなコード例がありますか?

よくある質問

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

Node.jsでPDFファイルを画像に変換するにはIronPDFの`rasterizeToImageFiles`メソッドを使用する。まずIronPDFを `npm install @ironsoftware/ironpdf` でインストールし、`PdfDocument.fromFile()` を使ってPDFを読み込み、希望の出力パスを指定して `rasterizeToImageFiles()` を呼び出す。このメソッドは、ファイルの拡張子から画像フォーマットを自動的に検出します。

PDFを変換するときにサポートされている画像形式は何ですか?

IronPDFはPDFをJPG、PNG、GIF、その他の一般的なフォーマットを含む複数の画像フォーマットに変換することをサポートしています。rasterizeToImageFiles`メソッドは出力パスに指定したファイル拡張子に基づいて出力フォーマットを自動的に決定します。

PDFの特定のページを画像に変換できますか?

はい、IronPDFでは`rasterizeToImageFiles`メソッドを使用する際に、すべてのページを変換することも、特定のページを選択して変換することもできます。これにより、PDF文書のどのページを画像ファイルに変換するかを完全にコントロールすることができます。

PDF から画像への変換のインストール要件は何ですか?

PDFを画像に変換するには、`npm install @ironsoftware/ironpdf` を使ってIronPDFをインストールする必要がある。このライブラリはIronPDF Engineをシステムにインストールする必要があり、IronPDF EngineはPDFのレンダリング処理を行う。本番環境での使用にはライセンスキーの設定が必要です。

変換は高画質を維持しますか?

はい、IronPDFは高画質を維持しながら効率的に変換処理を行います。rasterizeToImageFiles`メソッドにより、PDFコンテンツは画質を大きく損なうことなく正確に画像としてレンダリングされます。

PDFから画像への変換プロセスは非同期ですか?

はい、IronPDFの変換処理はプロミスを用いて非同期に実行されます。変換に成功した場合は `.then()` を、PDFから画像への変換処理中にエラーが発生した場合は `.catch()` を使用します。

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

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

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

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

準備はできましたか?
バージョン: 2026.3 リリース
Still Scrolling Icon

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

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