groupdocs viewer dwg – Java에서 GroupDocs.Viewer를 사용하여 특정 CAD 도면 렌더링하는 방법

DWG 파일에서 특정 레이아웃을 렌더링하는 것은 단일 디자인 뷰에 집중하거나 가벼운 HTML 미리보기를 생성하거나, 특정 도면 레이어를 웹 페이지에 삽입해야 할 때 일반적인 요구 사항입니다. 이 튜토리얼에서는 GroupDocs.Viewer for Java가 선택한 레이아웃을 렌더링하고, CAD를 HTML로 변환하며, 레이아웃 DWG를 몇 줄의 코드만으로 추출하는 방법을 쉽게 보여줍니다.

GroupDocs.Viewer for Java로 특정 CAD 도면 렌더링

빠른 답변

  • DWG를 HTML로 렌더링하는 라이브러리는 무엇인가요? GroupDocs.Viewer for Java.
  • DWG에서 하나의 레이아웃만 렌더링할 수 있나요? Yes – HtmlViewOptions에 레이아웃 이름을 지정합니다.
  • 개발에 라이선스가 필요합니까? 무료 체험판으로 테스트가 가능하며, 프로덕션에서는 영구 라이선스가 필요합니다.
  • 필요한 Java 버전은 무엇인가요? JDK 8 이상.
  • 대용량 CAD 파일에서 메모리 사용이 문제인가요? 스트리밍 옵션을 사용하고 Viewer 인스턴스를 즉시 닫으세요.

groupdocs viewer dwg란 무엇인가요?

GroupDocs.Viewer는 HTML, PNG, JPEG와 같은 웹 친화적인 형식으로 DWG를 포함한 50개 이상의 문서 및 CAD 형식을 변환하는 Java 라이브러리입니다. 네이티브 CAD 소프트웨어 없이 파일을 처리하여 플랫폼 간 일관된 렌더링을 제공합니다.

DWG 렌더링에 GroupDocs.Viewer를 사용하는 이유

GroupDocs.Viewer는 50개 이상의 CAD 입력 형식을 지원하며, 페이지를 필요에 따라 스트리밍하여 메모리 사용량을 200 MB 이하로 유지하면서 수백 페이지에 달하는 도면을 렌더링할 수 있습니다. 내장된 레이아웃 추출 기능을 통해 단일 뷰를 분리할 수 있어 전체 도면을 렌더링할 때보다 페이지 로드 시간을 최대 **70 %**까지 줄일 수 있습니다.

필수 조건

  • GroupDocs.Viewer for Java ≥ 25.2.
  • Maven을 사용한 의존성 관리.
  • JDK 8+이 로컬에 설치되어 있어야 합니다.
  • DWG 파일 구조(레이아웃, 모델 공간, 페이퍼 공간)에 대한 기본적인 이해.

DWG 파일에서 특정 레이아웃을 렌더링하는 방법

원하는 DWG 파일을 로드하고 HTML 렌더링 옵션을 구성한 뒤 출력할 레이아웃을 지정합니다. HtmlViewOptions에 레이아웃 이름을 설정하면 뷰어가 해당 뷰만 추출하여 해당 HTML 파일을 생성합니다. 이 접근 방식은 미리보기 생성을 단순화하고 처리 시간을 줄이며, 전체 작업 흐름은 세 단계로 구성됩니다.

1단계: 출력 디렉터리 정의

생성된 HTML 파일이 저장될 폴더를 만듭니다.

Utils 도우미는 렌더링된 파일을 위한 플랫폼 독립적인 출력 폴더를 생성합니다.

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

설명: Utils.getOutputDirectoryPath는 플랫폼 독립적인 경로를 만들고 폴더가 없으면 생성합니다.

2단계: 렌더링된 페이지 이름 지정 설정

페이지 번호를 위한 자리표시자를 포함하는 이름 패턴을 지정합니다.

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

설명: {0}은 페이지 인덱스로 대체되어 파일 이름 충돌 없이 여러 레이아웃을 렌더링할 수 있습니다.

3단계: HtmlViewOptions 구성

뷰어에 리소스를 임베드하고 단일 레이아웃을 대상으로 하도록 지시합니다.

HtmlViewOptions는 리소스 임베드와 레이아웃 선택을 포함하여 출력 HTML이 생성되는 방식을 구성합니다.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

설명: forEmbeddedResources는 이미지와 CSS를 HTML에 직접 포함시켜 레이아웃당 하나의 휴대용 파일을 생성합니다.

4단계: 렌더링할 레이아웃 선택

DWG 파일에 표시된 정확한 레이아웃 이름을 제공합니다.

layoutName 속성은 뷰어가 렌더링할 도면 레이아웃을 지정합니다.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

설명: layoutName을 "Model"(또는 다른 사용자 정의 레이아웃)으로 설정하면 GroupDocs.Viewer가 다른 모든 뷰를 무시하도록 지시합니다.

5단계: 레이아웃 렌더링 및 정리

try‑with‑resources 블록에서 뷰어를 열고 view를 호출하면 Java가 인스턴스를 자동으로 닫습니다.

Viewer 클래스는 GroupDocs.Viewer를 사용해 문서를 렌더링하기 위한 주요 진입점입니다.

viewOptions.getCadOptions().setLayoutName("Model");

설명: view 호출은 선택된 레이아웃을 출력 폴더의 HTML 파일로 스트리밍하며, 렌더링이 끝난 후 뷰어가 즉시 해제됩니다.

일반적인 문제 및 해결책

  • Layout not found – CAD 편집기에서 DWG를 열어 레이아웃 이름을 확인하세요; 철자와 대소문자가 정확히 일치해야 합니다.
  • Out‑of‑memory errors – Viewer.setMemoryLimit를 활성화하거나 파일을 더 작은 청크로 처리하세요.
  • Missing images – forEmbeddedResources가 설정되어 있는지 확인하세요; 그렇지 않으면 외부 이미지 파일이 별도로 생성될 수 있습니다.

자주 묻는 질문

Q: GroupDocs.Viewer for Java란 무엇인가요?
A: 서버 측 라이브러리로, DWG를 포함한 50개 이상의 문서 및 CAD 형식을 설치된 Office 또는 CAD 소프트웨어 없이 HTML, PNG, JPEG로 변환합니다.

Q: GroupDocs.Viewer의 임시 라이선스를 어떻게 얻을 수 있나요?
A: GroupDocs’ purchase page를 방문하여 개발 및 테스트용 무료 임시 라이선스를 요청하세요.

Q: GroupDocs.Viewer가 매우 큰 DWG 파일을 효율적으로 처리할 수 있나요?
A: 예, 페이지를 스트리밍하고 수백 페이지에 달하는 도면을 메모리 사용량을 200 MB 이하로 유지하면서 렌더링할 수 있습니다. 각 작업 후 Viewer 인스턴스를 닫아야 합니다.

Q: DWG 레이아웃을 HTML이 아닌 PDF로 직접 변환할 수 있나요?
A: 물론 가능합니다 – HtmlViewOptions를 PdfViewOptions로 교체하고 동일한 레이아웃 이름을 지정하면 PDF 출력이 생성됩니다.

Q: 레이아웃 추출에 대한 더 많은 예제를 어디서 찾을 수 있나요?
A: 공식 문서와 API 레퍼런스에 배치 처리 및 맞춤 렌더링 파이프라인을 위한 추가 코드 스니펫이 포함되어 있습니다.

실용적인 적용 사례

  1. Architectural presentations – 고객 회의를 위해 필요한 평면도 레이아웃만 표시합니다.
  2. Manufacturing reviews – 전체 어셈블리를 로드하지 않고 허용 오차를 논의하기 위해 부품 뷰를 분리합니다.
  3. E‑learning modules – 명확한 교육을 위해 웹 기반 튜토리얼에 단일 CAD 뷰를 삽입합니다.
  4. Document management integration – DWG 파일을 콘텐츠 저장소에 업로드할 때 레이아웃별 미리보기를 자동으로 추출합니다.
  5. Custom reporting – 단일 도면 뷰에 초점을 맞춘 HTML 보고서를 생성하여 파일 크기와 로드 시간을 줄입니다.

성능 팁

  • Viewer 인스턴스 재사용 – 가능한 경우 여러 파일에 대해 Viewer 인스턴스를 재사용하면 내부 리소스를 캐시하고 이후 렌더링 속도를 높입니다.
  • Enable streaming – Viewer.setRenderMode(RenderMode.Stream)을 호출하여 메모리 사용량을 낮게 유지합니다.
  • Compress output HTML – 웹 서버에서 gzip으로 압축하여 클라이언트 측 로드 시간을 더욱 개선합니다.

결론

이제 GroupDocs.Viewer for Java를 사용하여 DWG 파일에서 특정 레이아웃을 렌더링하기 위한 완전하고 프로덕션 준비된 접근 방식을 갖추었습니다. 단일 레이아웃을 대상으로 하면 렌더링 시간이 감소하고 메모리 사용량이 낮아지며, 웹 포털부터 내부 대시보드까지 어디에든 삽입할 수 있는 깔끔한 HTML을 생성합니다.

다음 단계

  • "Top View" 또는 "Section A"와 같은 다른 레이아웃 이름을 렌더링해 보며 출력이 어떻게 변하는지 확인하세요.
  • 동일한 레이아웃의 PDF 버전이 필요하면 PdfViewOptions를 살펴보세요.
  • 이 기술을 GroupDocs.Annotation과 결합하여 렌더링된 HTML에 워터마크나 주석을 추가하세요.

최종 업데이트: 2026-06-20
테스트 환경: GroupDocs.Viewer for Java 25.2
작성자: GroupDocs

리소스

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_DWG_WITH_LAYOUTS_AND_LAYERS)) {
    viewer.view(viewOptions);
}

관련 튜토리얼