DWG 파일이란?

DWG는 AutoCAD에서 2‑D 및 3‑D 설계 데이터를 저장하기 위해 사용하는 고유 바이너리 형식입니다. 여기에는 벡터 기하, 레이어, 텍스트 및 엔지니어링 도면, 평면도, 기계 부품 및 유사한 기술 도면을 설명하는 메타데이터가 포함됩니다. 형식이 독점적이기 때문에 대부분의 일반 이미지 뷰어는 기하 정보를 해석할 수 없으며, 전용 CAD 파서가 필요합니다.

.NET 개발자가 웹 포털에서 DWG를 렌더링해야 하는 이유

솔루션이 문서 중심 포털—예를 들어 DMS, CRM, 엔지니어링 포털 또는 법률 기술 케이스 뷰어—이라면 건축가, 기계 엔지니어 또는 계약업체로부터 DWG 파일을 받게 됩니다. 사용자는 무거운 데스크톱 CAD 프로그램을 다운로드하지 않고도 해당 파일을 즉시 미리 보기 원합니다. 브라우저 내 미리 보기를 제공하면 마찰이 사라지고, 지원 티켓이 감소하며, 워크플로우를 안전한 애플리케이션 경계 안에 유지할 수 있습니다.

폴백 시나리오를 위한 DWG → PDF 변환

모든 클라이언트가 벡터 CAD를 직접 렌더링할 수 있는 것은 아닙니다(예: 오래된 브라우저나 화면 판독기). DWG를 PDF로 변환하면 라인 작업과 레이어 가시성을 유지하면서 보편적으로 볼 수 있는 표현을 얻을 수 있습니다.

Doconut의 Converter Plugin은 서버 측에서 이 변환을 수행합니다:

• Microsoft Office나 AutoCAD 설치가 필요 없습니다.
• 변환은 .NET 프로세스 또는 Docker 컨테이너 내부에서 실행되어 데이터가 여러분의 제어 하에 유지됩니다.
• 출력된 PDF는 캐시하여 이후 뷰에 재사용할 수 있어 CPU 부하를 줄입니다.

일반적인 흐름:

1. DWG 파일의 경로(또는 스트림)와 함께 변환기를 호출합니다.
2. PDF 파일을 받습니다(경로나 스트림 형태).
3. 원본 DWG와 함께 PDF를 저장해 빠르게 조회할 수 있도록 합니다.

.NET 프런트엔드에서 DWG 직접 표시

전체 CAD 경험—줌, 팬, 레이어 토글—이 필요하면 Doconut의 Universal Document Viewer를 사용합니다. 뷰어는 DWG 파일을 네이티브하게 받아 서버에서 벡터 데이터를 파싱하고 이미지 타일을 브라우저로 스트리밍합니다. 클라이언트는 HTML/JavaScript를 받아 캔버스에 타일을 렌더링하여 부드럽고 Office‑없는 경험을 제공합니다.

통합을 위한 핵심 포인트:

• ASP.NET Core 파이프라인에 뷰어 미들웨어를 등록합니다(예: app.UseDoconut(...)).
• 미들웨어가 타일 요청을 자동으로 처리하므로 추가 라우팅 코드는 필요 없습니다.
• 뷰어가 스트림을 지원하므로 앞서 만든 임시 저장소에서 직접 데이터를 전달할 수 있습니다.

결과는 DWG를 인터랙티브한 줌, 팬, 레이어 제어와 함께 표시하는 <iframe> 혹은 준비된 React/Angular/Vue 컴포넌트가 됩니다.

전체 흐름: 엔드‑투‑엔드 DWG 미리 보기 워크플로우

1. 업로드 – 사용자가 DWG 파일을 포털에 끌어다 놓습니다.
2. 검증 및 저장 – 서버가 파일을 확인하고 저장합니다.
3. 선택적 변환 – PDF 폴백이 필요하면 Converter Plugin을 호출하고 PDF를 캐시합니다.
4. 렌더링 – Doconut SDK를 사용해 DWG 문서를 열고 뷰어 토큰을 얻습니다. 뷰어 미들웨어가 프런트엔드에 필요한 타일을 제공합니다.
5. 인터랙션 – 사용자는 줌, 팬, 레이어 토글이 가능하고, “Download PDF”를 클릭하면 3단계에서 캐시한 PDF를 제공합니다.

이 모든 단계는 .NET 6/8 애플리케이션 내부에서 수행되며 외부 CAD 바이너리, Office 설치 또는 제3자 서비스를 요구하지 않습니다.

Doconut NuGet 패키지를 솔루션에 추가하고, 뷰어 미들웨어를 구성한 뒤 AutoCAD에서 내보낸 샘플 DWG를 업로드해 보세요. 파일이 브라우저에서 즉시 렌더링되는 것을 확인할 수 있으며, 한 줄의 코드로 정적 뷰를 원하는 사용자를 위해 PDF도 생성할 수 있습니다. 이 통합은 요구 사항을 충족시키고 이해관계자에게 DWG 콘텐츠를 직접 보여줄 수 있게 해줍니다.