PDF 파일을 이미지 파일로 변환하는 방법

PDF 파일을 JPEG 형식으로 변환하는 방법은 무엇인가요?

기본적으로 rasterizeToImageFiles는 대상 경로에 지정된 파일 형식에 따라 문서를 변환합니다. 이 자동 형식 감지 기능을 통해 코드 변경 없이 이미지 형식을 쉽게 전환할 수 있습니다.

샘플 PDF 파일을 JPG 파일로 변환하려면 대상 경로에서 파일 확장자를 변경하세요.

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

또는 ImageType 옵션을 지정하십시오. ImageType 값은 대상 경로에 선언된 이미지 파일 형식을 재정의합니다. 이렇게 하면 rasterizeToImageFiles가 변환을 수행할 때 파일 이름을 무시하게 되어 출력 형식을 명시적으로 제어할 수 있습니다.

다음 예제에는 rasterizeToImageFiles 호출과 함께 JSON 옵션 인수가 포함되어 있으며, 이 호출은 ImageType를 선언합니다.

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 메서드를 사용하십시오. 이 메서드는 지정된 형식으로 각 페이지를 별도의 이미지로 생성하고 파일 이름에 페이지 번호를 자동으로 추가합니다. 이 기능은 이미지 갤러리를 만들거나 여러 페이지로 구성된 문서를 작업할 때 유용합니다.

두 페이지 분량의 샘플 PDF 문서입니다.

다음 예제 코드는 위에 제시된 두 페이지짜리 PDF 파일에서 두 개의 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");
});

두 페이지로 구성된 PDF 파일에 rasterizeToImageFiles 메서드를 적용한 결과입니다. 이 메서드는 원본 파일의 각 페이지에 대한 이미지를 생성합니다.

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

여러 페이지로 구성된 문서에서 특정 페이지를 래스터화하려면 fromPages 속성을 가진 JSON 객체를 사용하십시오. 이 선택적 변환은 대용량 PDF 파일에서 특정 페이지만 필요한 경우, 즉 PDF 파일에서 특정 페이지를 제거하는 것과 유사한 방식으로 특정 페이지만 필요한 경우에 유용합니다.

다음 코드 예제는 이 대용량 샘플 파일 의 첫 번째, 네 번째, 여섯 번째 및 아홉 번째 페이지만 비트맵으로 변환합니다.

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);
});

IronPDF는 options 인수에 지정한 페이지에 대해서만 PDF-to-Image 작업을 수행했습니다.

선택적 페이지 변환 기능은 지원되는 모든 이미지 형식에서 작동하며 사용자가 지정한 품질 설정을 유지합니다. 더욱 복잡한 페이지 조작을 위해서는 모든 옵션과 메서드가 자세히 설명된 포괄적인 API 참조를 살펴보세요.

API 문서는 어디에서 찾을 수 있나요?

PdfDocument 클래스와 해당 rasterizeToImageFiles 메서드에 대한 API 문서를 참조하여 해당 메서드를 필요에 맞게 수정하는 방법에 대한 자세한 내용을 확인하십시오. 문서에는 사용 가능한 모든 매개변수 및 옵션에 대한 자세한 정보가 제공됩니다.

다른 코드 예제는 무엇이 있나요?

• IronPDF를 사용하여 PDF를 이미지로 변환 : 추가 구성 옵션과 함께 약간 다른 방식으로 사용되는 rasterizeToImageFiles을 참조하십시오.
• IronPDF를 사용하여 이미지를 PDF 파일로 변환하기 : 하나 이상의 이미지를 하나의 PDF 파일로 변환하는 방법, 즉 역변환 작업을 알아보세요.
• 다중 프레임 TIFF를 PDF로 변환 : 다중 페이지 이미지 형식을 PDF로 변환할 때 처리하는 방법을 살펴보세요. 이는 다중 페이지 PDF를 이미지로 변환하는 것과 유사한 개념을 공유합니다.