GroupDocs.Viewer Java를 사용하여 DWG를 JPG로 렌더링: 단계별 튜토리얼

소개

GroupDocs.Viewer Java를 사용하여 DWG를 JPG로 렌더링하면 복잡한 CAD 도면을 가볍고 웹 친화적인 이미지로 쉽게 변환할 수 있습니다. 이 가이드에서는 라이브러리를 설정하고, 출력 경로를 구성하며, 이미지 크기와 품질을 제어하는 PC3 파일을 사용하는 방법을 보여드립니다. 마지막까지 읽으면 몇 줄의 Java 코드만으로 DWG 파일을 JPG로 자동 변환할 수 있게 됩니다.

빠른 답변

• 변환을 처리하는 라이브러리는 무엇인가요? GroupDocs.Viewer for Java.
• 생성되는 파일 형식은 무엇인가요? JPG images.
• 개발에 라이선스가 필요합니까? 테스트용으로는 무료 체험판을 사용할 수 있지만, 프로덕션에서는 정식 라이선스가 필요합니다.
• 이미지 크기를 제어할 수 있나요? 예, PC3 구성 파일을 통해 가능합니다.
• Java 8이면 충분한가요? Java 8 이상을 완전히 지원합니다.

“render dwg as jpg”란 무엇인가요?

Render dwg as jpg는 DWG (AutoCAD) 도면을 JPEG 래스터 이미지로 변환하는 과정입니다. 이 변환은 시각적 정확성을 유지하면서 파일을 브라우저, 이메일 또는 모바일 앱에서 쉽게 볼 수 있게 합니다. 또한 파일 크기를 크게 줄여 로딩 시간을 단축하고 다양한 플랫폼 및 장치에 보다 간편하게 배포할 수 있습니다.

왜 GroupDocs.Viewer for Java를 사용하나요?

GroupDocs.Viewer는 **50+**개의 입력 형식을 지원합니다—DWG, DXF, DWF 등을 포함—전체 파일을 메모리에 로드하지 않고도 수백 페이지에 달하는 도면을 렌더링할 수 있습니다. 이 라이브러리는 표준 8CPU 서버에서 일반적인 200페이지 CAD 파일을 5초 미만으로 처리하여 선 굵기와 색상을 유지한 고품질 JPG를 제공합니다.

전제 조건

필요한 라이브러리 및 종속성

• GroupDocs.Viewer for Java – 버전 25.2 (또는 이후).

환경 설정 요구 사항

• Java Development Kit 8 또는 그 이후 버전.
• Maven 또는 Gradle을 사용한 종속성 관리.

지식 전제 조건

• 기본 Java 구문.
• 파일 시스템 경로에 대한 이해.

GroupDocs.Viewer for Java 설정

시작하려면 필요한 종속성을 포함하십시오. Maven을 사용하는 경우 다음 구성을 추가합니다:

<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>

라이선스 획득

• 무료 체험: GroupDocs 무료 체험에서 체험 버전을 다운로드하십시오.
• 임시 라이선스: GroupDocs 임시 라이선스에서 전체 기능 접근을 위한 임시 라이선스를 얻으십시오.
• 구매: GroupDocs 구매를 통해 장기 사용 라이선스를 구매하십시오.

추가 리소스

• GroupDocs Viewer 문서
• API 레퍼런스
• GroupDocs.Viewer 다운로드
• 라이선스 구매
• 무료 체험
• 임시 라이선스
• 지원 포럼

기본 초기화

Viewer 클래스는 문서를 로드하고 페이지를 다양한 형식으로 렌더링하는 메서드를 제공합니다. 환경을 설정하고 종속성을 추가한 후, Java 애플리케이션에서 GroupDocs.Viewer를 초기화하십시오:

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/dwg/file.dwg")) {
            // Your rendering code will go here.
        }
    }
}

구현 가이드

특정 구성으로 CAD 도면 렌더링

이 기능을 사용하면 PC3 파일에 정의된 설정을 사용하여 DWG 파일을 JPG 이미지로 렌더링할 수 있습니다.

개요

DWG 도면을 로드하고, JpgViewOptions를 생성한 뒤, 페이지 크기, DPI 및 선 렌더링 스타일을 정의하는 사용자 지정 PC3 파일을 옵션에 지정합니다.

단계별 구현

필요한 패키지 가져오기

JpgViewOptions는 JPEG 이미지의 해상도, 페이지 크기 및 출력 형식과 같은 렌더링 설정을 지정하고, Viewer는 실제 변환을 수행합니다.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
import java.nio.file.Path;
import java.nio.file.Paths;

출력 디렉터리 및 파일 경로 정의

출력 폴더는 생성된 이미지를 정리된 상태로 유지하고 배치 처리 후 정리를 쉽게 해줍니다.

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

CAD 도면 로드 및 구성 설정

Viewer는 DWG 파일을 읽고, setRenderOptions 메서드는 각 페이지를 렌더링하기 전에 PC3 구성을 적용합니다.

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_DWG_WITH_LAYOUTS_AND_LAYERS)) {
    JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
    
    // Set the PC3 configuration for rendering
    options.getCadOptions().setPc3File(TestFiles.SAMPLE_PC3_CONFIG);
    
    // Render the CAD drawing to a JPG image
    viewer.view(options);
}

문제 해결 팁

• 누락된 종속성: Maven 좌표가 설치한 버전과 일치하는지 확인하십시오.
• 잘못된 경로: 절대 경로 또는 Path.of(...)를 사용하여 플랫폼별 문제를 방지하십시오.

렌더링 출력 경로 구성

올바른 경로 처리는 파일을 찾을 수 없음 오류를 방지하고 배치 작업을 간소화합니다.

출력 디렉터리 경로 정의

렌더링된 이미지를 원본 파일 이름을 딴 하위 폴더에 저장하면 쉽게 찾을 수 있습니다.

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

렌더링된 이미지 파일 경로 구성

drawing_page_{page}.jpg와 같은 명명 패턴은 나중에 개별 페이지를 참조해야 할 때 도움이 됩니다.

Path pageFilePathFormat = outputDirectory.resolve("pc3_result.jpg");

실제 적용 사례

1. 건축 설계 – CAD 소프트웨어가 없는 클라이언트와 건축 도면을 공유합니다.
2. 엔지니어링 프로젝트 – PowerPoint 프레젠테이션에 상세 회로도를 포함합니다.
3. 인테리어 디자인 – 평면도 DWG 파일에서 무드보드 이미지를 빠르게 생성합니다.

성능 고려 사항

• 리소스 관리: 렌더링이 끝나면 viewer.close()를 호출하여 파일 핸들을 해제하십시오.
• 메모리 튜닝: 매우 큰 DWG 파일의 경우 JVM 힙(-Xmx2g)을 늘려 OutOfMemoryError를 방지하십시오.

GroupDocs.Viewer Java를 사용하여 DWG를 JPG로 렌더링하는 방법은?

new Viewer("drawing.dwg")로 DWG를 로드하고, PC3 파일을 가리키는 JpgViewOptions 객체를 생성한 뒤, viewer.view(pageNumber, options, outputStream)을 호출합니다. 이 한 줄 호출은 요청된 페이지를 고품질 JPG로 렌더링하면서 PC3 레이아웃 규칙을 자동으로 적용합니다. 또한 메서드는 렌더링 메타데이터를 반환하여 변환 후 페이지 수와 이미지 크기를 확인할 수 있습니다.

PC3 구성 파일이란 무엇인가요?

PC3 파일은 페이지 크기, 플롯 스타일, DPI 및 라인웨이트 스케일링을 정의하는 일반 텍스트 AutoCAD 구성 파일입니다. 사용자 지정 PC3를 제공하면 모든 렌더링된 도면에 대해 이미지 크기를 표준화할 수 있습니다. PC3를 편집하여 여백, 용지 방향 및 색상 매핑을 제어함으로써 모든 변환에 일관된 시각적 결과를 보장합니다.

일반적인 문제와 해결책

• 빈 이미지: PC3 파일이 유효한 플로터를 참조하고 DWG에 인쇄 가능한 레이어가 포함되어 있는지 확인하십시오.
• 저해상도: PC3 파일 내 DPI 설정을 높이거나 options.setResolution(300)을 프로그래밍 방식으로 설정하십시오.
• 라이선스 오류: 라이선스 파일이 애플리케이션 클래스패스에 배치되어 있는지와 체험 기간이 만료되지 않았는지 확인하십시오.

자주 묻는 질문

Q: DWG의 여러 페이지를 한 번에 렌더링할 수 있나요?
A: 예, 페이지 번호를 반복하고 각 페이지마다 viewer.view(page, options, stream)를 호출하면 됩니다; 라이브러리는 각 JPG를 독립적으로 스트리밍합니다.

Q: GroupDocs.Viewer가 다른 래스터 형식을 지원하나요?
A: 물론입니다 – PngViewOptions, BmpViewOptions, TiffViewOptions를 사용하여 각각 PNG, BMP, TIFF로 렌더링할 수 있습니다.

Q: 처리할 수 있는 DWG 파일의 최대 크기는 얼마인가요?
A: 엔진은 최대 2 GB까지의 파일을 처리합니다; 더 큰 파일은 렌더링 전에 도면을 별도 파일로 분할하십시오.

Q: 별도의 CAD 설치가 필요합니까?
A: 아니요, GroupDocs.Viewer는 AutoCAD를 설치할 필요 없이 서버 측에서 완전히 렌더링을 수행합니다.

Q: 호환되는 Java 버전은 무엇인가요?
A: Java 8, 11, 17 및 그 이후 버전을 완전히 지원합니다.

결론

이제 GroupDocs.Viewer for Java를 사용하여 render dwg as jpg를 수행하는 완전하고 프로덕션 준비된 접근 방식을 갖추었습니다. 이 튜토리얼에서는 환경 설정, PC3 기반 구성, 경로 처리 및 성능 팁을 다루었습니다. 이 패턴을 배치 파이프라인, 웹 서비스 또는 데스크톱 유틸리티에 통합하여 모든 CAD 도면의 빠르고 고품질 JPEG 미리보기를 제공하십시오.

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

관련 튜토리얼

• GroupDocs.Viewer for Java를 사용하여 사용자 지정 크기 및 배경색으로 CAD 도면을 PNG로 렌더링하는 방법
• GroupDocs.Viewer와 함께 CAD 레이어를 Java로 렌더링 – 완전 가이드
• 효율적인 렌더링을 위해 GroupDocs.Viewer Java를 사용하여 CAD 도면을 타일로 분할