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

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

 npm과 @ironsoftware/ironpdf

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

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

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

rasterizeToImageFiles 메소드는 PDF 문서를 읽고 제공한 출력 경로에 페이지당 하나의 이미지 파일을 작성합니다. 단일 페이지 PDF의 경우 정확히 하나의 이미지를 생성합니다. 다중 페이지 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

PdfDocument.fromFile은 PDF를 로드하고 PdfDocument 객체로 해석되는 프로미스를 반환합니다. .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

옵션 객체의 type 속성은 파일 이름 확장자보다 우선합니다. 위의 예에서는 rasterizeToImageFiles이 생성하도록 하여도 .png으로 끝나는 경로에서라도 JPEG 파일을 생성합니다. GIF 및 BMP 출력에도 동일한 패턴이 적용됩니다.

DPI 설정이 출력 품질에 어떤 영향을 미치나요?

옵션 객체의 dpi 속성은 래스터화된 출력의 픽셀 밀도를 제어합니다. 높은 값은 더 많은 세부 정보를 담은 더 큰 파일을 생성합니다; 낮은 값은 선명도를 희생하여 파일 크기를 줄입니다.

팁dpi: 300을 설정하면, 고해상도 인쇄 또는 보관에 적합한 인쇄 품질의 이미지를 생성합니다. 화면 표시 또는 썸네일 생성의 경우, 웹 사용에 충분한 명확성을 유지하면서 파일 크기를 줄이는 dpi: 96입니다.

대부분의 아카이브나 미리보기 시나리오에서 150 DPI는 합리적인 기본값입니다 — 출력은 화면에서 읽기에 충분히 선명하고 파일 크기는 관리 가능한 수준으로 유지됩니다. 변환 후 인쇄되거나 OCR 처리가 될 콘텐츠의 경우, 300 DPI 이상이 권장됩니다.

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

여러 페이지의 PDF를 이미지로 변환하려면 어떻게 해야 하나요?

하나 이상의 페이지가 포함된 문서의 경우, rasterizeToImageFiles은 페이지당 하나의 이미지를 생성합니다. IronPDF는 추가 코드 없이 출력을 잘 정리할 수 있도록 각 출력 파일 이름에 0 기반 페이지 인덱스를 추가합니다.

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

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

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

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

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

옵션 객체의 fromPages 속성은 0 기반 페이지 인덱스 배열을 수락합니다. 지정된 페이지만 래스터화됩니다; 나머지는 모두 건너뜁니다. 대규모 PDF에서 일부 페이지만 필요한 경우 유용합니다 — 예를 들어 문서 미리보기를 위한 표지와 섹션 시작 페이지를 추출할 때. 변환하기 전에 개별 페이지와 작업해야 할 경우, Node.js API 레퍼런스 PdfDocument에서 추가적인 페이지 수준 작업을 문서화합니다.

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

fromPages 배열에 지정된 네 개의 페이지만 IronPDF가 래스터화했습니다. 다른 페이지는 처리되지 않았습니다.

fromPages의 페이지 인덱스는 0부터 시작하므로, [0, 3, 5, 8]은 첫 번째, 네 번째, 여섯 번째, 아홉 번째 페이지를 대상으로 합니다. DPI 값인 150은 아카이브 또는 미리보기 사용 사례에 알맞은 출력 품질과 파일 크기를 균형있게 유지합니다. 선택적 변환은 지원되는 모든 이미지 유형과 호환됩니다.

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

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

더 나아가려면 IronPDF Node.js API 레퍼런스를 확인하여 rasterizeToImageFiles 및 PdfDocument 클래스의 모든 매개변수를 문서화합니다. PDF를 이미지로 변환하는 코드 예제는 추가 구성을 사용한 rasterizeToImageFiles을 보여줍니다. 반대 방향으로 작업하려면, 이미지를 PDF 파일로 변환하거나 다중 프레임 TIFF 파일을 PDF로 변환을 참조하십시오.

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

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