Node.js에서 PDF를 이미지 파일로 변환하는 방법

Node.js 용 IronPDF 어떻게 설치하나요?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

IronPDF의 Node.js 패키지를 npm에서 설치하여 PDF를 PNG, JPG, GIF, BMP 및 다른 이미지 형식으로 변환합니다.

프로덕션 환경에서 이미지를 PDF로 변환하기 전, 라이선스 키를 설정하세요. 이 패키지는 또한 모든 PDF 렌더링 작업을 처리하는 IronPDF 엔진 설치를 요구합니다. 변환 기능을 위해 반드시 설치되어야 합니다.

PDF 파일을 이미지 파일로 변환하는 방법은 무엇인가요?

rasterizeToImageFiles 메서드는 PDF 문서를 읽어들이고, 사용자가 지정한 출력 경로에 페이지당 하나의 이미지 파일을 작성합니다. 단일 페이지 PDF/A의 경우, 정확히 하나의 이미지를 생성합니다. 다중 페이지 PDF인 경우, IronPDF는 각 파일 이름에 페이지 번호 접미사를 자동으로 추가합니다.

아래 예제는 Learning Container에서 제공하는 샘플 PDF를 로드하여 PNG 파일로 변환합니다.

뷰어에서 열려 있는 샘플 PDF 파일. 이 파일과 다른 테스트 PDF를 Learning Container에서 다운로드하십시오.

//: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는 세 줄의 코드로 문서를 변환합니다.

이 메서드의 옵션에 대한 더 자세한 예제는 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을 사용하면 페이지당 하나의 이미지가 생성됩니다. IronPDF는 추가 코드 없이 출력을 잘 정리할 수 있도록 각 출력 파일 이름에 0 기반 페이지 인덱스를 추가합니다.

두 페이지 샘플 PDF. IronPDF는 변환 중 페이지마다 하나의 이미지 파일을 생성합니다.

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

위의 두 페이지 PDF로부터 생성된 두 PNG 파일. IronPDF는 각 출력 파일에 페이지 번호를 붙입니다.

이 자동 페이지 분할 동작은 지원되는 모든 이미지 형식에서 작동합니다. 다음 섹션의 fromPages 옵션을 함께 사용하면 대용량 문서에서 특정 페이지만 변환할 수 있습니다. 반대 방향으로 작업하기 위해서는, 이미지를 PDF로 변환하는 예제를 참조하십시오. 여러 이미지 파일을 단일 PDF 문서로 결합하는 방법을 보여줍니다.

특정 페이지만 변환하려면 어떻게 해야 하나요?

options 객체의 fromPages 속성은 0을 기준으로 하는 페이지 인덱스 배열을 받아들입니다. 지정된 페이지만 래스터화됩니다; 나머지는 모두 건너뜁니다. 대규모 PDF에서 일부 페이지만 필요한 경우 유용합니다 — 예를 들어 문서 미리보기를 위한 표지와 섹션 시작 페이지를 추출할 때. 변환 전에 개별 페이지를 처리해야 하는 경우, PdfDocument에 대한 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]는 첫 번째, 네 번째, 여섯 번째, 아홉 번째 페이지를 대상으로 합니다. DPI 값인 150은 아카이브 또는 미리보기 사용 사례에 알맞은 출력 품질과 파일 크기를 균형있게 유지합니다. 선택적 변환은 지원되는 모든 이미지 유형과 호환됩니다.

PDF를 이미지로 변환하기 위한 다음 단계는 무엇인가요?

IronPDF의 rasterizeToImageFiles 메서드는 일관된 API를 통해 형식 선택, 다중 페이지 분할 및 선택적 페이지 변환을 처리합니다. 옵션 객체는 형식 재정의, DPI 제어 및 페이지 필터링을 위한 단일 확장 포인트입니다.

더 자세한 내용은 IronPDF for Node.js API 레퍼런스 문서에서 rasterizeToImageFiles 및 PdfDocument 클래스에서 사용할 수 있는 모든 매개변수를 확인할 수 있습니다. PDF to Images 코드 예제에서는 추가 구성과 함께 rasterizeToImageFiles이 사용된 것을 보여줍니다. 반대 방향으로 작업하려면, 이미지를 PDF 파일로 변환하거나 다중 프레임 TIFF 파일을 PDF로 변환을 참조하십시오.

IronPDF for Node.js의 무료 체험을 시작하여 독자적인 프로젝트에서 PDF-이미지 변환을 테스트하십시오. 라이선스 옵션 보기를 통해 팀에 맞는 플랜을 찾으십시오.

IronPDF로 무엇을 할 수 있는지 준비되셨습니까? 전체 Node.js 튜토리얼을 여기서 확인하세요: Node.js에서 HTML을 PDF로 변환