GroupDocs Viewer for Java를 사용하여 PDF를 PNG로 변환

이 포괄적인 가이드에서는 Java에서 PDF를 PNG로 변환하는 방법을 알아보고 각 페이지를 정확한 원본 크기로 유지하는 방법을 설명합니다. 원본 페이지 크기를 보존하는 것은 법적 제출물, 브랜드 일관성을 유지한 마케팅 자산, 그리고 스케일링이 측정을 깨뜨릴 수 있는 기술 도면에 필수적입니다. 우리는 GroupDocs.Viewer 설치, 렌더링 옵션 구성, 일반적인 문제 해결 방법을 단계별로 안내하여 매번 픽셀 완벽한 PNG 이미지를 생성할 수 있도록 도와드립니다.

Render PDFs in Original Size with GroupDocs.Viewer for Java

빠른 답변

  • Java에서 PDF를 PNG로 변환할 수 있는 라이브러리는 무엇인가요? GroupDocs.Viewer for Java는 convert pdf to png에 대한 직관적인 API를 제공합니다.
  • 원본 페이지 크기를 어떻게 유지하나요? PdfOptions 객체에서 setRenderOriginalPageSize(true)를 호출합니다.
  • 프로덕션에 라이선스가 필요합니까? 예 – 비시험용으로는 영구 또는 임시 GroupDocs 라이선스가 필요합니다.
  • 암호로 보호된 PDF를 렌더링할 수 있나요? 물론입니다; Viewer 인스턴스를 생성할 때 비밀번호를 제공하면 됩니다.
  • 필요한 Java 버전은 무엇인가요? JDK 8 이상이 완전히 지원됩니다.

“원본 크기로 PDF 렌더링”이란?

PDF를 원본 크기로 렌더링한다는 것은 각 페이지를 정확한 차원으로 스케일링 없이 내보낸다는 의미입니다. PDF를 렌더링할 때 뷰어는 페이지를 대상 형식에 맞게 스케일링하거나 소스 파일에 정의된 정확한 차원을 유지할 수 있습니다. 원본 크기로 렌더링하면 각 페이지가 픽셀 단위로 정확히 내보내지며, 이는 법적 문서, 아카이브 자료 및 레이아웃 정확성이 중요한 모든 시나리오에 필수적입니다.

왜 PDF 페이지 크기를 보존해야 할까요?

원본 PDF 페이지 크기를 보존하면 시각적 레이아웃, 정밀한 측정값 및 디자인 요소가 변환 후에도 그대로 유지되어 법적 준수, 브랜드 일관성 및 기술 도면이나 양식의 정확성을 보장합니다. 또한 그래픽이 의도치 않게 잘리거나 왜곡되는 것을 방지하여 서명 및 워터마크가 모든 플랫폼에서 정확히 표시되도록 합니다.

사전 요구 사항

  • Java Development Kit (JDK): 버전 8 이상.
  • GroupDocs.Viewer for Java: Maven을 통해 라이브러리를 추가하세요(아래 참고).
  • IDE: IntelliJ IDEA, Eclipse 또는 Java와 호환되는 편집기.

GroupDocs.Viewer for Java 설정

Maven 구성

공식 GroupDocs 저장소와 Viewer 의존성을 pom.xml에 추가합니다. (코드 블록을 수정하지 마세요 – 그대로 유지해야 합니다.)

<repositories>
   <repository>
      <id>groupdocs-repo</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득

GroupDocs는 세 가지 라이선스 옵션을 제공합니다: 무료 체험(무제한 페이지, 제한된 기간), 임시 라이선스(최대 30일 동안 전체 기능), 그리고 영구 구매(제한 없는 프로덕션 사용). 프로젝트 일정에 맞는 옵션을 선택하세요.

구현 가이드

단계 1: GroupDocs.Viewer 초기화

Viewer는 문서를 로드하고 렌더링 기능을 제공하는 핵심 클래스입니다. Viewer 인스턴스를 생성하고 PngViewOptions를 구성합니다. PngViewOptions는 페이지를 PNG 이미지로 렌더링하기 위한 설정을 정의합니다. 핵심 호출인 viewOptions.getPdfOptions().setRenderOriginalPageSize(true);는 엔진에 원본 페이지 크기 설정을 지시합니다.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

import java.nio.file.Path;

public class RenderOriginalPageSize {
    public static void main(String[] args) {
        // Define output directory path for rendered pages
        Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
        
        // Format for the output page file paths
        String pageFilePathFormat = "page_{0}.png";
        Path pageFilePath = outputDirectory.resolve(pageFilePathFormat);
        
        // Initialize PngViewOptions with the path format
        PngViewOptions viewOptions = new PngViewOptions(pageFilePath.toString());
        
        // Set option to render original page size for PDF documents
        viewOptions.getPdfOptions().setRenderOriginalPageSize(true);
        
        // Create a Viewer instance for the source PDF document
        try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF")) {
            // Render the PDF using the specified options
            viewer.view(viewOptions);
        }
    }
}

핵심 라인 설명

  • Path Configuration: 각 렌더링된 PNG가 저장될 위치를 결정합니다.
  • PngViewOptions: PNG를 출력 형식으로 선택합니다(전형적인 pdf to png java 시나리오).
  • Render Original Page Size: 스케일링이 발생하지 않도록 보장하여 각 PDF 페이지의 정확한 차원을 유지합니다.

단계 2: 실행 및 검증

PDF를 로드하고 렌더링 루틴을 호출한 뒤 생성된 PNG 파일을 확인합니다. 이미지가 원본 PDF 페이지 차원과 픽셀 단위로 일치해야 합니다. 이미지가 늘어나 보인다면 setRenderOriginalPageSize(true)가 포함되어 있는지, 최신 GroupDocs.Viewer 버전을 사용하고 있는지 다시 확인하세요.

문제 해결 및 일반적인 함정

  • Incorrect file paths: outputDirectory와 소스 PDF 경로가 절대 경로나 프로젝트에 맞는 상대 경로인지 확인하세요.
  • Missing license: 유효한 라이선스가 없으면 렌더링이 제한된 페이지 수를 가진 체험 모드로 전환될 수 있습니다.
  • Out‑of‑memory errors on large PDFs: JVM 힙(-Xmx2g 이상)을 늘리거나 페이지 지연 로딩을 활성화하세요.
  • Encrypted PDFs: Viewer 인스턴스를 생성할 때 비밀번호를 제공하여 pdf rendering troubleshooting 오류를 방지하세요.

실용적인 사용 사례

  1. Digital Archives: 왜곡 없이 역사적 스캔을 보존합니다.
  2. Legal Document Portals: 법원에 제출된 그대로 정확히 표시되는 PDF를 제공합니다.
  3. E‑Learning Platforms: 레이아웃을 유지하면서 교과서를 이미지 형식으로 변환합니다.
  4. Invoice Automation: 변환 후에도 항목 및 합계가 읽기 쉬운 상태를 유지합니다.

성능 팁

  • Memory Management: 대용량 문서를 위해 충분한 힙 공간을 할당합니다.
  • Lazy Loading: 가능하면 전체 파일이 아니라 필요한 페이지만 렌더링합니다.
  • Caching: 자주 접근되는 PDF에 대해 렌더링된 PNG를 저장해 반복 처리를 피합니다.

자주 묻는 질문

Q: GroupDocs.Viewer를 Spring Boot와 어떻게 통합하나요?
A: Viewer를 Spring Bean으로 등록하고 필요한 곳에 주입하여 스레드‑안전하게 재사용하도록 Spring이 관리하도록 합니다.

Q: PNG 외의 형식으로 PDF를 렌더링할 수 있나요?
A: 예 – GroupDocs.Viewer는 JPEG, SVG 및 PDF‑to‑HTML 변환도 지원합니다.

Q: 렌더링 과정에서 예외가 발생하면 어떻게 해야 하나요?
A: 파일 경로나 라이선스 문제와 같은 원인을 찾기 위해 스택 트레이스를 확인하고 PDF가 손상되지 않았는지 검증하세요.

Q: 렌더링 가능한 PDF 크기 제한이 있나요?
A: 기술적으로 제한은 없지만 매우 큰 파일은 JVM 메모리를 늘리거나 작은 섹션으로 분할하는 것이 좋습니다.

Q: GroupDocs.Viewer는 암호로 보호된 PDF를 처리하나요?
A: 물론입니다 – 비밀번호를 Viewer 생성자 또는 LoadOptions 객체에 전달하면 됩니다.

리소스

마지막 업데이트: 2026-06-25
Tested With: GroupDocs.Viewer 25.2 for Java
Author: GroupDocs

관련 튜토리얼