GroupDocs.Redaction .NET을 사용하여 페이지를 PNG로 변환

대용량 문서에서 단일 페이지의 미리보기를 만드는 것은 필요한 정보만 공유하고자 할 때 흔히 필요한 작업입니다. 이 튜토리얼에서는 GroupDocs.Redaction for .NET을 사용하여 페이지를 PNG로 변환하는 방법을 배우고, 미리보기 출력을 구성하며, 결과를 애플리케이션에 통합하는 방법을 다룹니다. 전제 조건, 설치, 코드 설정 및 실용적인 팁을 단계별로 안내하여 몇 분 안에 단일 페이지 PNG 미리보기를 생성할 수 있도록 합니다.

빠른 답변

  • 한 페이지만의 PNG 미리보기를 생성할 수 있나요? 예, 페이지 번호와 형식을 지정하려면 PreviewOptions를 사용하십시오.
  • GroupDocs.Redaction이 미리보기에 지원하는 형식은 무엇인가요? PNG가 기본이며, JPEG와 BMP도 사용할 수 있습니다.
  • 개발에 라이선스가 필요합니까? 무료 체험판으로 테스트가 가능하지만, 상업적 사용을 위해서는 정식 라이선스가 필요합니다.
  • .NET Core와 .NET Framework에서도 작동합니까? 예, 이 라이브러리는 .NET Standard 2.0+을 대상으로 합니다.
  • 대용량 파일에 대해 메모리 효율적인가요? 예, API가 페이지를 스트리밍하여 전체 문서를 로드하지 않으므로 메모리를 절약합니다.

페이지를 PNG로 변환이란?

convert page to PNG는 지원되는 문서(PDF, DOCX, PPTX 등)에서 단일 페이지를 추출하여 해당 페이지를 Portable Network Graphics(PNG) 이미지로 렌더링하는 것을 의미합니다. 결과 이미지에는 원본 페이지의 시각적 레이아웃, 글꼴 및 그래픽이 보존되어, 문서의 나머지 부분을 숨긴 채 명확한 스냅샷을 공유할 수 있습니다.

단일 페이지 미리보기를 사용하는 이유

단일 페이지 PNG 미리보기를 생성하면 대역폭을 절감하고 로딩 시간을 단축하며, 필요한 부분만 노출함으로써 민감한 콘텐츠를 보호할 수 있습니다. GroupDocs.Redaction은 일반적인 서버 하드웨어에서 300페이지 PDF를 0.5초 미만에 200 KB PNG로 렌더링할 수 있어 웹 포털 및 보고 도구에 이상적입니다.

전제 조건

  • GroupDocs.Redaction for .NET – 문서 가리기 및 미리보기 생성을 수행하는 핵심 라이브러리입니다.
  • System.IO – 파일 처리를 위한 표준 .NET 네임스페이스입니다.
  • .NET Core 3.1+ 또는 .NET Framework 4.6.1+ ( .NET Standard 2.0을 지원하는 모든 플랫폼).
  • 기본적인 C# 지식과 NuGet 패키지 관리에 대한 이해.

GroupDocs.Redaction for .NET 설정

설치 정보

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet 패키지 관리자 UI

  • Visual Studio에서 프로젝트를 엽니다.
  • Manage NuGet Packages를 선택합니다.
  • GroupDocs.Redaction을 검색하고 최신 안정 버전을 설치합니다.

라이선스 획득 단계

임시 라이선스를 요청하려면 GroupDocs website를 방문하십시오.
이메일로 받은 지침에 따라 라이선스 파일을 프로젝트에 추가하십시오.

기본 초기화 및 설정

RedactionEngine 클래스는 미리보기 생성을 포함한 모든 작업의 진입점입니다.

using GroupDocs.Redaction;

var redactor = new Redactor("path/to/your/document");

구현 가이드

개요

이 섹션에서는 PreviewOptions를 구성하고 미리보기 API를 호출하여 페이지를 PNG로 변환하는 방법을 보여줍니다. 이 방법은 PDF, DOCX, PPTX 및 GroupDocs.Redaction이 지원하는 다양한 형식에 적용됩니다.

단계 1: 환경 준비

소스 파일 경로와 출력 폴더를 설정합니다. Path.Combine을 사용하여 플랫폼에 독립적인 경로를 만듭니다.

// Define the directory and file name for output.
string sourceFile = Utils.PrepareOutputDirectory("YOUR_DOCUMENT_DIRECTORY");

단계 2: 미리보기 옵션 설정

PreviewOptions를 사용하면 페이지 번호, 이미지 크기 및 출력 형식을 정의할 수 있습니다. 이 클래스는 미리보기 생성을 위한 구성 허브 역할을 합니다.

int testPageNumber = 1;
string previewFileName = Utils.GetOutputFileByName(sourceFile, $"preview_page{testPageNumber}");

// Initialize the Redactor with the source file.
using (Redactor redactor = new Redactor(sourceFile))
{
    PreviewOptions options = new PreviewOptions(pageNumber => File.OpenWrite(previewFileName));

    // Set dimensions and format for the preview image.
    options.Width = 480;
    options.Height = 640;
    options.PageNumbers = new int[] { testPageNumber };
    options.PreviewFormat = PreviewOptions.PreviewFormats.PNG;

    // Generate and save the page preview.
    redactor.GeneratePreview(options);
}

주요 구성 설명

  • Width & Height – 대상 디스플레이 해상도에 맞게 이 값을 조정합니다.
  • PageNumbers – 렌더링하려는 정확한 페이지 인덱스(0부터 시작)를 배열로 제공하십시오.
  • PreviewFormat – 기본값은 PNG이며, 파일 크기를 줄이려면 PreviewFormat.Jpeg로 전환합니다.

문제 해결 팁

PNG가 생성되지 않을 경우:

  • 소스 파일 경로가 올바르고 파일에 접근할 수 있는지 확인하십시오.
  • API 메서드를 호출하기 전에 라이선스 파일이 로드되었는지 확인하십시오.
  • PreviewOptions.PageNumbers에 유효한 페이지 인덱스가 포함되어 있는지 확인하십시오(예: 첫 페이지는 0).

실용적인 적용 사례

단일 페이지 PNG 미리보기를 생성하면 많은 시나리오에서 유용합니다:

  1. Client Presentations – 관련 슬라이드 또는 계약 조항만 표시합니다.
  2. Internal Reviews – 전체 문서를 열지 않고도 빠른 시각적 검토를 가능하게 합니다.
  3. Content Summaries – 이메일이나 대시보드에 페이지 스냅샷을 삽입하여 즉시 컨텍스트를 제공합니다.

이 기능을 CMS 또는 CRM에 통합하면 업로드된 문서에 대한 썸네일 생성을 자동화하여 사용자 경험을 향상시킬 수 있습니다.

성능 고려 사항

  • Memory Management – 사용 후 RedactionEngine 인스턴스를 해제하여 리소스를 확보하십시오.
  • Asynchronous Execution – UI 애플리케이션에서 인터페이스 응답성을 유지하려면 await engine.GeneratePreviewAsync(...)를 사용하십시오.
  • Library Updates – GroupDocs.Redaction은 30개 이상의 입력 및 출력 형식을 지원하며, 전체 파일을 메모리에 로드하지 않고 최대 500페이지 문서를 처리합니다. 성능 향상을 위해 패키지를 최신 상태로 유지하십시오.

결론

이제 GroupDocs.Redaction for .NET을 사용하여 페이지를 PNG로 변환하고 단일 페이지 미리보기를 생성하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. 위 단계들을 따라 하면 모든 .NET 애플리케이션에 고품질 PNG 스냅샷을 삽입하여 문서 공유를 향상시키면서 보안과 성능을 유지할 수 있습니다.

자주 묻는 질문

Q: 암호로 보호된 PDF에 대한 미리보기를 생성할 수 있나요?
A: 예, RedactionEngine 초기화 시 비밀번호를 제공하면 미리보기가 정상적으로 생성됩니다.

Q: 출력 형식을 PNG에서 JPEG로 변경하려면 어떻게 해야 하나요?
A: 미리보기 메서드를 호출하기 전에 options.PreviewFormat = PreviewFormat.Jpeg를 설정하십시오.

Q: 한 번에 여러 페이지를 미리볼 수 있나요?
A: 가능합니다 – options.PageNumbers에 페이지 번호 배열을 할당하면 됩니다(예: new[] {0, 2, 4}).

Q: 미리보기 이미지가 흐릿하면 어떻게 해야 하나요?
A: options.Width와 options.Height를 더 높은 해상도로 늘리십시오; 라이브러리가 이미지 크기를 그에 맞게 조정합니다.

Q: Linux 컨테이너에서도 작동하나요?
A: 예, GroupDocs.Redaction .NET은 크로스 플랫폼이며 .NET Core를 지원하는 Docker 컨테이너 내에서도 실행됩니다.

리소스

마지막 업데이트: 2026-06-06
테스트 환경: GroupDocs.Redaction 5.6 for .NET
작성자: GroupDocs

관련 튜토리얼