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<//code>. 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のNode.jsモジュールが提供するrasterizeToImageFilesメソッドを使用してください。 PDFをJPG、PNG、その他の画像形式に変換するために、このメソッドを設定します。 すべてのページを変換するか、特定のページを選択します。 IronPdfは変換プロセスを完全にコントロールすることができます。

PDFから画像へ変換するIronPDFをインストールするには? ```shell npm install @ironsoftware/ironpdf ``` **IronPDFのNode.jsモジュールをNPMからインストールし、PDFをPNG、JPG、GIF、その他の画像タイプに変換する**。 PDFを画像に変換する前に、[ライセンスキー](https://ironpdf.com/nodejs/get-started/license-keys/)を設定してください。 このライブラリは、[PDFレンダリング処理を行うIronPdf Engineがシステムにインストールされている必要があります](https://ironpdf.com/nodejs/get-started/use-ironpdfengine/)。 ## PDFを画像に変換するには? [プレースホルダテキストを含む1ページのサンプルPDFドキュメント](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-file.pdf)を使用して作業します。 より複雑なシナリオについては、[まずHTMLをPDFに変換し](https://ironpdf.com/nodejs/tutorials/html-to-pdf/)、その結果を画像に変換することを検討してください。 [画像形式に変換する前にLorem Ipsumテキスト文書を表示するPDFビューア](/static-assets/ironpdf-nodejs/how-to/nodejs-pdf-to-image/nodejs-pdf-to-image-1.webp)。 *サンプルPDFファイルがPDFビューアアプリケーションで開かれている画像。* [Learning Container](https://www.learningcontainer.com/)からテスト用にこのPDFファイルやその他をダウンロードできます。** 以下のソースコードでは、PDFファイルをPNGファイルに変換します。 ```nodejs 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`クラスを返します。このオブジェクトは[プロミス](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises)に含まれているので、プロミスが解決したときに実行するコールバック関数をアタッチします。 コールバックの内部で、解決されたオブジェクトに対して`rasterizeToImageFiles`を呼び出し、単一ページのドキュメントを画像に変換します。 引数として、翻訳先のパス(ファイル名と拡張子を含む)を指定します。 この方法は、IronPDFが[PDFへの画像埋め込み](https://ironpdf.com/nodejs/examples/embed-image-base64/)を処理する方法と同様に、様々なフォーマットをサポートします。 [PDFファイルからドキュメントの内容を示す変換されたPNG画像](/static-assets/ironpdf-nodejs/how-to/nodejs-pdf-to-image/nodejs-pdf-to-image-2.webp)。 *上記のソースコードから生成された画像です。* IronPDFはサンプルPDFをたった3行のコードでPNGファイルに変換しました!** Learning Containerは、テスト用に[サンプルPDFファイル](https://www.learningcontainer.com/sample-pdf-files-for-testing/?expand_article=1)を提供します。 [この例で使用されているサンプルPDFファイル](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-file.pdf)を無料でダウンロードできます。 上記の例を、サイズや複雑さの異なる他のPDFで試してみてください。 より詳細な画像変換の例については、[包括的なPDF to Imagesガイド](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/)をご覧ください。 ## どのような高度な画像変換オプションがありますか? ### PDFをJPEG形式に変換するにはどうすればよいですか? デフォルトでは、`rasterizeToImageFiles`は宛先パスで指定されたファイルタイプに従ってドキュメントを変換します。 この自動フォーマット検出機能により、コードを変更することなく、画像フォーマットを簡単に切り替えることができます。 サンプルPDFをJPGファイルに変換するには、変換先パスのファイル拡張子を変更してください: ```nodejs // Convert PDF to JPG (not to PNG) pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg"); ``` または、`ImageType`オプションを指定してください。 `ImageType`値は、出力先パスで宣言された画像ファイルタイプを上書きします。 これは、`rasterizeToImageFiles` が変換を実行するときにファイル名を無視するように強制し、出力形式に対する明示的な制御を提供します。 次の例では、`ImageType` を宣言する rasterizeToImageFiles の呼び出しに JSON オプション引数を含めています。 ```nodejs 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の値に従います。 このアプローチは、明示的な型指定が優先される[他の変換操作](https://ironpdf.com/nodejs/examples/converting-a-url-to-a-pdf/)をIronPDFがどのように扱うかに似ています。 この例は、PDFをGIFやビットマップ形式を含む他の画像形式に変換するために適応させることができます。 **ヒント:**このアプローチは、自動ファイル命名システムで作業するときや、異なる出力フォーマット間で一貫した命名規則を維持するときなど、ファイル名を特定のタイプに変更することが実行不可能な場合に役立ちます。 ### 複数ページのPDFを画像に変換するにはどうすればよいですか? 複数のページを持つドキュメントを変換するには、`rasterizeToImageFiles`メソッドを同じように使用します。 このメソッドでは、各ページを指定されたタイプの別の画像として作成し、ファイル名にページ番号を自動的に付加します。 この機能は、画像ギャラリーを作成するときや、[複数ページのドキュメント](https://ironpdf.com/nodejs/examples/merge-pdfs/)を扱うときに便利です。 [画像変換処理前のサンプルコンテンツを示すビューアで開いた2ページのPDF文書](/static-assets/ironpdf-nodejs/how-to/nodejs-pdf-to-image/nodejs-pdf-to-image-3.webp)。 **2ページのサンプルPDFドキュメント。** 次のサンプルコードブロックは、上記の2ページのPDFファイルの例から2つのPNGファイルを生成します。 ```nodejs 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ファイル、ファイル名の自動ページ番号を示す](/static-assets/ironpdf-nodejs/how-to/nodejs-pdf-to-image/nodejs-pdf-to-image-4.webp)。 **2ページのPDFファイルに`rasterizeToImageFiles`メソッドを使用した結果です。メソッドは元のファイルの各ページごとに画像を作成します。** ### 特定のページだけを変換するにはどうすればよいですか? マルチページのドキュメントから特定のページをラスタライズするには、`fromPages` プロパティを持つ JSON オブジェクトを使用します。 この選択的変換は、[PDFから特定のページを削除する方法](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)のように、特定のページだけが必要な大きなPDFを扱うときに便利です。 次のコード例は、この[大きなサンプルファイル](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-with-images.pdf)の最初、4番目、6番目、および9番目のページだけをビットマップに変換します。 ```nodejs 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ページを画像に変換することに成功しました。 **IronPDFは`options`引数で指定したページにのみPDFから画像への操作を実行しました。** 選択的ページ変換機能は、サポートされているすべての画像形式で動作し、指定した品質設定を維持します。 より複雑なページ操作については、[包括的なAPIリファレンス](https://ironpdf.com/nodejs/object-reference/api/)を参照してください。

IronPDFを使い始める

## その他のリソースはどこで見つけることができますか? ### APIドキュメントはどこで見つけることができますか? [`PdfDocument`クラス](https://ironpdf.com/nodejs/object-reference/api/)とその`rasterizeToImageFiles`メソッドに関するAPIドキュメントを読んで、あなたのニーズに合うようにメソッドを適応させる方法についての洞察を深めてください。 ドキュメントは、利用可能なすべてのパラメータとオプションに関する詳細な情報を提供します。 ### 他にどのようなコード例がありますか? - [**IronPDFを使ってPDFを画像に変換する**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/): `rasterizeToImageFiles`を参照してください。 - [**IronPDFを使って画像をPDFファイルに変換する**](https://ironpdf.com/nodejs/examples/image-to-pdf/):1つまたは複数の画像を1つのPDFファイルに変換する方法を学びます。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/): 複数ページのPDFから画像への変換と同様のコンセプトを共有する、PDFへの変換時に複数ページの画像フォーマットを処理する方法を探ります。

よくある質問

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にとって、その仕事は価値があり、実際の影響があるため、満足感があります。

準備はできましたか?
バージョン: 2025.12 リリース