GroupDocs.Conversion for .NET을 사용하여 DGN을 PNG로 변환하는 방법: 완전 가이드
DGN 파일을 PNG 이미지로 변환하는 것은 엔지니어, 건축가 및 CAD 도면을 가볍고 웹 친화적인 이미지로 공유해야 하는 모든 사람에게 일반적인 작업입니다. 이 튜토리얼에서는 GroupDocs.Conversion for .NET을 사용하여 convert dgn to png 를 빠르고 안정적으로 수행하는 방법을 배웁니다. 설치, DGN 파일 로드, PNG 옵션 구성 및 결과 저장 과정을 단계별로 안내하며 각 단계가 성능과 정확도에 왜 중요한지 설명합니다.
빠른 답변
- 변환을 처리하는 라이브러리는 무엇입니까? GroupDocs.Conversion for .NET.
- 한 번의 호출로 다중 페이지 DGN을 변환할 수 있나요? Yes – the API processes each page automatically.
- 기본 사용에 라이선스가 필요합니까? A trial works for development; a full license is required for production.
- 지원되는 .NET 버전은 무엇입니까? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
- 변환이 메모리 효율적입니까? Yes, it streams pages and never loads the whole file into RAM.
GroupDocs.Conversion for .NET이란?
GroupDocs.Conversion for .NET은 CAD 도면, PDF, 이미지 및 오피스 문서를 포함한 100개 이상의 파일 형식 간 프로그래밍 방식 변환을 가능하게 하는 강력한 SDK입니다. 전체 문서를 메모리에 로드하지 않고 500 MB까지의 파일을 처리하므로 서버‑사이드 배치 작업에 이상적입니다.
CAD 도면에 GroupDocs.Conversion을 사용하는 이유
GroupDocs.Conversion은 속도, 정확성 및 확장성을 결합하여 CAD 도면 처리에 이상적입니다. 복잡한 DGN 파일을 빠르게 변환하면서 벡터 데이터를 보존하고, 배치 처리를 지원하며, 플랫폼 간에 작동하여 엔지니어링 및 건축 워크플로우에 신뢰할 수 있는 결과를 보장합니다.
- 속도: 일반적인 클라우드 VM에서 300페이지 DGN을 PNG로 변환하는 데 12초 미만이 걸립니다.
- 정확성: 벡터 기하학, 레이어 및 래스터 이미지를 99.9 % 정확도로 보존합니다.
- 확장성: 비동기 및 병렬 처리를 지원하여 하루에 수천 개의 파일을 처리할 수 있습니다.
- 크로스‑플랫폼: .NET Core와 함께 Windows, Linux, macOS에서 작동합니다.
사전 요구 사항
- 필수 라이브러리: GroupDocs.Conversion for .NET (NuGet을 통해 설치).
- 개발 환경: Visual Studio 2022 또는 .NET 6+를 지원하는 모든 IDE.
- 기본 C# 지식: 네임스페이스, 클래스 및 async 패턴에 익숙함.
GroupDocs.Conversion을 설치하는 방법은?
NuGet을 사용하면 SDK 설치가 간단합니다. 패키지에는 필요한 모든 바이너리와 종속성이 포함되어 있어 프로젝트에 추가한 즉시 파일 변환을 시작할 수 있습니다. 최신 안정 버전을 가져와 빌드 파이프라인에 통합하는 Package Manager Console 또는 .NET CLI 중 하나를 선택할 수 있습니다.
패키지 관리자 콘솔
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI
dotnet add package GroupDocs.Conversion --version 25.3.0
패키지를 추가한 후, GroupDocs 웹사이트에서 체험판 또는 정식 라이선스를 얻으세요(purchase page) 또는 임시 평가 라이선스를 요청하세요(temporary license) 그리고 애플리케이션 구성에 추가합니다.
dgn을 png로 변환하는 방법은?
Converter 인스턴스로 DGN 파일을 로드하고 PNG 옵션을 구성한 뒤 Convert 메서드를 호출합니다. API는 각 페이지를 MemoryStream으로 스트리밍하므로 이를 디스크에 쓰거나 클라이언트에 반환할 수 있습니다. 이 접근 방식은 대형 도면에서도 메모리 사용량을 낮게 유지합니다.
.NET 프로젝트에서 GroupDocs.Conversion을 설정하는 방법은?
설정은 라이선스 키를 추가하고 소스 파일을 가리키는 Converter 인스턴스를 만드는 것을 포함합니다. 이는 SDK가 변환을 수행하도록 준비하고 모든 작업이 라이선스 조건을 준수하도록 보장합니다.Converter 클래스는 GroupDocs.Conversion 내에서 파일 로드 및 변환을 관리하는 핵심 구성 요소입니다.
using GroupDocs.Conversion;
// Initialize a converter object with the path to your DGN file
string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";
Converter converter = new Converter(dgnFilePath);
변환을 위해 DGN 파일을 로드하는 방법은?
Converter를 파일 경로와 함께 생성하여 DGN 파일을 로드합니다. 이 단계는 파일을 검증하고 이후 변환 작업을 위해 준비합니다.Converter 클래스는 소스 문서를 열고 처리할 페이지를 노출합니다.
string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";
// Load the DGN file using GroupDocs.Conversion's Converter class
Converter converter = new Converter(dgnFilePath);
PNG 변환 옵션을 구성하는 방법은?
PNG 변환 설정은 ImageConvertOptions 객체를 통해 정의되며, 여기서 출력 형식, 해상도 및 시각적 속성을 지정할 수 있습니다. 이러한 옵션을 조정하면 결과 이미지의 품질과 크기를 제어합니다.ImageConvertOptions 클래스는 DPI, 배경 색상, 페이지 크기 등 이미지 출력에 대한 모든 구성 가능한 매개변수를 포함합니다.
using GroupDocs.Conversion.Options.Convert;
// Initialize image conversion options with desired output format
ImageConvertOptions options = new ImageConvertOptions
{
Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png
};
변환을 실행하고 PNG 파일을 저장하는 방법은?
변환은 Converter에서 Convert 메서드를 호출하고 옵션과 각 페이지에 대한 스트림을 생성하는 대리자를 전달하여 시작됩니다. 이 메서드는 문서를 페이지별로 처리하고 PNG 데이터를 제공된 스트림에 씁니다.Convert 메서드는 지정된 옵션을 사용하여 소스 형식에서 대상 형식으로 실제 변환을 수행합니다.
using System.IO;
string outputFolder = "YOUR_OUTPUT_DIRECTORY";
string outputFileTemplate = Path.Combine(outputFolder, "converted-page-{0}.png");
// Define a method to create file streams for each page being converted
Func<SavePageContext, Stream> getPageStream = savePageContext =>
new FileStream(string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);
// Perform the conversion from DGN to PNG using the Converter object and options defined earlier
converter.Convert(getPageStream, options);
실용적인 사용 사례
- 건축 회사는 CAD 소프트웨어가 없는 클라이언트와 설계 스냅샷을 공유합니다.
- 건설 관리자는 프로젝트 관리 도구에 PNG 미리보기를 삽입하여 빠른 시각 검사를 수행합니다.
- 마케팅 팀은 원본 CAD 소스를 노출하지 않고 브로셔 및 온라인 포트폴리오용 고해상도 이미지를 추출합니다.
성능 팁
Converter객체를 사용이 끝나는 즉시 해제하여 관리되지 않는 리소스를 해제합니다.- 많은 파일을 웹 API에서 처리할 때는 비동기 변환(
ConvertAsync)을 선호하여 요청 스레드를 자유롭게 유지합니다. - CPU 및 메모리 사용량을 모니터링하십시오; 200 MB보다 큰 파일의 경우 페이지를 배치 처리하는 것을 고려하세요.
자주 묻는 질문
Q: DGN 및 PNG 외에 GroupDocs.Conversion이 처리할 수 있는 다른 형식은 무엇입니까?
A: PDF, DOCX, XLSX, PPTX, SVG, JPEG, BMP 및 DWG, DXF와 같은 다양한 CAD 형식을 포함하여 100개 이상의 형식을 지원합니다.
Q: 비밀번호로 보호된 DGN 파일을 어떻게 처리합니까?
A: LoadOptions 매개변수를 통해 비밀번호를 Converter 생성자에 전달하면 SDK가 변환 전에 파일을 복호화합니다.
Q: Linux 컨테이너에서 변환을 실행할 수 있나요?
A: 예, GroupDocs.Conversion for .NET은 Linux의 .NET Core와 완전히 호환되며 Docker를 사용해 서비스를 컨테이너화할 수 있습니다.
Q: 한 번의 요청으로 변환할 수 있는 페이지 수에 제한이 있나요?
A: 명확한 제한은 없지만, 매우 큰 도면(500 페이지 이상)의 경우 장시간 실행 요청을 피하기 위해 페이지를 청크로 처리하는 것이 좋습니다.
Q: 평가용 임시 라이선스는 어디서 얻을 수 있나요?
A: GroupDocs 웹사이트를 방문하여 체험 라이선스를 요청하십시오; 30일 동안 유효하며 모든 변환 기능을 사용할 수 있습니다.
마지막 업데이트: 2026-06-25
테스트 환경: GroupDocs.Conversion 25.3.0 for .NET
작성자: GroupDocs