Java에서 GroupDocs.Viewer를 사용하여 OBJ를 HTML, JPG, PNG 및 PDF로 변환하는 방법

3D OBJ 모델을 웹 친화적이거나 인쇄 가능한 형식으로 변환하는 것은 건축가, 전자상거래 플랫폼, e‑learning 제작자에게 흔한 요구사항입니다. 이 튜토리얼에서는 GroupDocs.Viewer for Java를 사용하여 OBJ 파일을 HTML, JPG, PNG 및 PDF로 변환하는 방법을 빠르고 안정적으로 알아봅니다.

Java에서 GroupDocs.Viewer for Java를 사용한 OBJ → HTML/JPG/PNG/PDF 변환

Quick Answers

주요 라이브러리는 무엇인가요? GroupDocs.Viewer for Java (v25.2)
OBJ를 어떤 형식으로 내보낼 수 있나요? HTML, JPG, PNG, PDF
라이선스가 필요합니까? 개발에는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 영구 라이선스가 필요합니다
Maven을 지원합니까? 예—pom.xml에 GroupDocs 저장소와 의존성을 추가하세요
이미지 품질을 커스터마이징할 수 있나요? 예, JpgViewOptions와 PngViewOptions를 사용합니다

What is OBJ Conversion and Why Do You Need It?

OBJ는 널리 사용되는 3D 기하학 정의 파일 형식입니다. CAD 및 모델링 도구에서는 강력하지만, 브라우저나 인쇄 문서에서 직접 볼 수 없습니다. OBJ를 HTML로 변환하면 인터랙티브 뷰어를 제공하고, JPG/PNG는 정적 스냅샷을 제공하며, PDF는 범용 공유 문서를 제공합니다. 이것이 바로 OBJ를 렌더링하는 방법이며, 다양한 전달 채널에 적합합니다.

Prerequisites

시작하기 전에 다음을 확인하세요:

GroupDocs.Viewer 25.2 (또는 이후 버전) – 변환을 담당하는 라이브러리.
Java 17+ 및 Maven이 개발 머신에 설치되어 있어야 합니다.
Java 프로그래밍 및 Maven 프로젝트 구조에 대한 기본적인 이해.

Setting Up GroupDocs.Viewer for Java

Maven Installation

아래와 같이 pom.xml에 저장소와 의존성을 정확히 추가합니다:

<repositories>
   <repository>
      <id>repository.groupdocs.com</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>

License Acquisition

무료 체험: GroupDocs 웹사이트에서 무료 체험판을 다운로드하세요.
임시 라이선스: 장기 테스트를 위해 여기에서 임시 라이선스를 획득하세요.
구매: 전체 기능 접근을 위해 이 링크에서 정식 라이선스를 구매하는 것을 고려하세요.

Basic Initialization

렌더링을 시작하려면:

필요한 클래스(Viewer, 뷰 옵션 클래스 등)를 import합니다.
Viewer 인스턴스를 생성하고 OBJ 파일을 지정합니다.
적절한 뷰 옵션(HTML, JPG, PNG, PDF)을 선택합니다.

이 기본 설정을 통해 지원되는 모든 형식으로 OBJ를 변환하는 방법을 구현할 수 있습니다.

Implementation Guide

아래에서 각 대상 형식에 대한 단계별 코드 스니펫을 확인하세요. 코드 블록은 원본 튜토리얼과 동일하게 유지되어 호환성을 보장합니다.

Rendering OBJ to HTML

OBJ를 렌더링하는 방법: 인터랙티브 HTML 페이지로.

Step‑by‑Step

출력 디렉터리 설정

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.html");

Viewer 인스턴스 생성

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

HTML 뷰 옵션 구성

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

OBJ 문서 렌더링

viewer.view(options);

Rendering OBJ to JPG

OBJ를 렌더링하는 방법: 고해상도 JPEG 이미지로.

Step‑by‑Step

출력 디렉터리 설정

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.jpg");

Viewer 인스턴스 생성

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

JPG 뷰 옵션 구성

JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);

OBJ 문서 렌더링

viewer.view(options);

Rendering OBJ to PNG

OBJ를 렌더링하는 방법: PNG를 사용해 투명도 지원.

Step‑by‑Step

출력 디렉터리 설정

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.png");

Viewer 인스턴스 생성

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

PNG 뷰 옵션 구성

PngViewOptions options = new PngViewOptions(pageFilePathFormat);

OBJ 문서 렌더링

viewer.view(options);

Rendering OBJ to PDF

OBJ를 렌더링하는 방법: 인쇄 가능한 PDF 문서로 (java convert 3d pdf 라고도 함).

Step‑by‑Step

출력 디렉터리 설정

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.pdf");

Viewer 인스턴스 생성

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

PDF 뷰 옵션 구성

PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);

OBJ 문서 렌더링

viewer.view(options);

Practical Applications

시나리오	OBJ를 변환하는 이유	선호 출력
건축 시각화	클라이언트와 인터랙티브 모델 공유	HTML 또는 PDF
온라인 제품 카탈로그	웹 페이지에 정적 미리보기 표시	JPG / PNG
교육 자료	e‑learning 모듈에 3D 다이어그램 삽입	HTML 또는 PDF
인쇄용 문서	고품질 인쇄용 시트 생성	PDF

Performance Considerations & Common Pitfalls

메모리 관리: 큰 OBJ 파일은 상당한 힙 공간을 차지할 수 있습니다. Viewer를 즉시 닫기 위해 (예시와 같이) try‑with‑resources 패턴을 항상 사용하세요.
품질 설정: JPG/PNG의 경우 JpgViewOptions.setResolution(int) 또는 PngViewOptions.setResolution(int)를 통해 해상도를 조정할 수 있습니다.
파일 경로: OBJ 파일 경로가 절대 경로나 프로젝트 루트에 대해 올바르게 해석되는지 확인하세요; 그렇지 않으면 FileNotFoundException이 발생합니다.
라이선스 오류: “License not found” 예외가 발생하면 라이선스 파일이 클래스패스에 배치되어 있는지, 비체험 실행 시 프로덕션용 라이선스를 사용하고 있는지 다시 확인하세요.

Frequently Asked Questions

Q: GroupDocs.Viewer for Java가 지원하는 형식은 무엇인가요?
A: HTML, JPG, PNG, PDF 등을 포함한 다양한 파일 형식을 지원합니다.

Q: OBJ 파일 렌더링 문제를 어떻게 해결하나요?
A: OBJ 파일 경로를 확인하고, 모든 종속 MTL 파일이 존재하는지 확인하며, Maven 의존성 버전이 설치한 라이브러리와 일치하는지 확인하세요.

Q: GroupDocs.Viewer가 큰 OBJ 파일을 효율적으로 처리할 수 있나요?
A: 네, 하지만 JVM 메모리 사용량을 모니터링하고 매우 큰 모델의 경우 힙 크기(-Xmx)를 늘리는 것을 고려하세요.

Q: 이미지 렌더링 시 출력 품질을 커스터마이징할 수 있나요?
A: 네, JpgViewOptions와 PngViewOptions에서 이미지 해상도 및 압축 설정을 조정할 수 있습니다.

Q: 임시 라이선스는 어떻게 얻나요?
A: 임시 라이선스를 여기에서 획득하세요.

마지막 업데이트: 2026-02-21
테스트 환경: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs