1. IronPDF
  2. 방법
  3. 회색조
C#에서 흑백 PDF 파일을 생성하는 방법

C#에서 흑백 PDF를 생성하는 방법

하릴 하시미 빈 오마르
하릴 하시미 빈 오마르
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF를 사용하면 GrayScale 속성을 true로 설정하여 PDF를 회색조로 렌더링할 수 있습니다. 이렇게 하면 컬러 콘텐츠를 회색 음영으로 변환하여 인쇄 비용을 절감하고 가독성을 향상시킬 수 있습니다.

빠른 시작: IronPDF를 사용하여 컬러 PDF를 흑백으로 변환하기

IronPDF를 사용하면 단 몇 줄의 코드로 컬러 PDF를 흑백 PDF로 변환할 수 있습니다. 웹 페이지 또는 HTML 콘텐츠를 회색조 PDF로 렌더링하려면 RenderingOptions의 GrayScale 속성을 설정하십시오. 이 가이드는 일관된 보기 환경을 위해 회색조 문서를 생성하는 방법을 보여줍니다.

Nuget Icon지금 바로 NuGet을 사용하여 PDF 만들기를 시작하세요.

  1. NuGet 패키지 관리자를 사용하여 IronPDF를 설치하세요.

    PM > Install-Package IronPdf

  2. 다음 코드 조각을 복사하여 실행하세요.

    var renderer = new IronPdf.ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("grayscale.pdf");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    지금 바로 무료 체험판을 통해 프로젝트에서 IronPDF를 사용해 보세요.
    arrow pointer
### 최소 워크플로우(5단계)
  1. 회색조 PDF 렌더링을 위한 IronPDF 라이브러리를 다운로드하세요.
  2. **`ChromePdfRenderer`** 클래스의 인스턴스를 생성합니다.
  3. **`RenderingOptions`** 의 **`GrayScale`** 속성을 true로 설정하십시오.
  4. URL, HTML 문자열 또는 파일에서 PDF 문서에 액세스하고 렌더링합니다.
  5. 흑백 PDF 문서를 원하는 위치로 내보냅니다.


흑백 PDF 파일을 어떻게 생성하나요?

회색조 PDF를 생성하려면 RenderingOptions의 GrayScale 속성을 true로 설정하십시오. 이 기능은 IronPDF의 포괄적인 렌더링 옵션 의 일부로, PDF 출력에 대한 세밀한 제어를 제공합니다.

제공된 코드 스니펫에서 회색조 기능은 ChromePdfRenderer를 인스턴스화한 후에 활성화됩니다. 그런 다음 RenderUrlAsPdf 메서드를 사용하여 웹 페이지를 렌더링합니다. 이 코드는 렌더링된 PDF의 첫 페이지만 추출하여 로컬에 저장합니다. IronPDF를 처음 사용하시는 분은 기본 사항을 익히는 데 도움이 되는 빠른 시작 가이드를 참조하세요.

GrayScale을 True로 설정하면 왜 색상이 변환되는 걸까요?

회색조 PDF는 모든 색상과 음영이 전체 색상 스펙트럼 대신 회색 음영을 사용하여 표현되는 문서입니다. 회색조 옵션을 활성화하면 IronPDF의 Chrome 렌더링 엔진이 업계 표준 휘도 계산을 사용하여 모든 RGB 색상 값을 해당 회색조 값으로 자동 변환합니다. 이렇게 하면 원본 문서의 시각적 계층 구조와 대비는 유지하면서 모든 색상 정보를 제거할 수 있습니다.

흑백 PDF는 언제 사용해야 할까요?

IronPDF는 PDF 문서를 컬러가 아닌 회색조로 렌더링합니다. PDF 문서를 흑백으로 인쇄하는 것은 대량 인쇄 시 비용 효율적입니다. 원본 색상이 지나치게 밝거나 선명할 경우, 흑백으로 렌더링하면 가독성이 향상됩니다. 흑백 PDF는 기기, 소프트웨어 및 플랫폼 전반에 걸쳐 호환성이 향상되어 일관된 보기 및 인쇄 환경을 보장합니다.

회색조 PDF의 일반적인 사용 사례는 다음과 같습니다.

  • 사업 보고서 : 재무 문서는 흑백으로 작성될 때 더 전문적으로 보이는 경우가 많습니다.
  • 법률 문서 : 법원 제출 서류 및 법률 요약서에는 일반적으로 흑백 형식이 필요합니다.
  • 학술 문서 : 연구 논문과 학위 논문은 일반적으로 흑백으로 인쇄됩니다.
  • 대량 인쇄 : 흑백 인쇄는 수백 페이지를 인쇄할 때 비용을 절감해 줍니다.
  • 보관 문서 : 장기 보관 및 PDF/A 규격 준수 에 적합합니다.

텍스트를 흑백으로 변환할 때 어떤 일이 발생하나요?

현재 그레이스케일 기능 구현은 렌더링된 PDF 문서의 텍스트를 이미지로 변환하므로 ExtractAllImages 메서드가 텍스트를 출력하지 않습니다.

현재 이 기능은 PDF를 렌더링할 때만 사용할 수 있습니다. 향후 업데이트에는 기존 PDF 문서를 흑백으로 변환하는 기능이 포함될 수 있습니다. 텍스트 추출 작업에 대한 자세한 내용은 텍스트 및 이미지 추출 가이드를 참조하세요.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-grayscale.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set GrayScale to true
renderer.RenderingOptions.GrayScale = true;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://ironsoftware.com/");
pdf.CopyPage(0).SaveAs("test.pdf");
$vbLabelText   $csharpLabel

고급 회색조 PDF 생성 예시

HTML 파일을 흑백 PDF로 변환하기

로컬 HTML 파일을 사용할 때, 해당 파일을 회색조 PDF로 변환할 수 있습니다. 이 기능은 색상 없이 렌더링해야 하는 미리 디자인된 템플릿이나 보고서가 있을 때 유용합니다. HTML 파일을 PDF로 변환하는 방법 에 대해 자세히 알아보세요.

using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
$vbLabelText   $csharpLabel

HTML 문자열에서 흑백 PDF 생성하기

동적 콘텐츠 생성을 위해 HTML 문자열을 회색조 PDF로 직접 변환하세요. 이 접근 방식은 송장, 영수증 또는 콘텐츠가 프로그램적으로 생성되는 모든 문서를 생성하는 데 효과적입니다. 더 자세한 내용은 HTML 문자열을 PDF로 변환하는 방법 에 대한 가이드를 참조하세요.

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
$vbLabelText   $csharpLabel

성능 고려 사항

회색조 PDF를 생성할 때 다음 성능 요소를 고려하십시오.

  1. 파일 크기 : 흑백 PDF는 컬러 버전보다 크기가 작아 이메일 첨부 파일이나 웹 다운로드에 적합합니다.
  2. 렌더링 속도 : 회색조 변환은 렌더링 시간에 최소한의 오버헤드만 추가합니다.
  3. 메모리 사용량 : 흑백 렌더링은 풀컬러 렌더링보다 메모리를 적게 사용하므로 대용량 문서에 유리합니다.

여러 개의 회색조 PDF 파일을 생성할 때 성능을 향상시키려면 비동기 및 멀티스레딩 기술을 사용하십시오.

다른 IronPDF 기능과의 통합

포괄적인 문서 처리를 위해 흑백 PDF를 다른 IronPDF 기능과 결합하십시오.

  • 머리글 및 바닥글 : 머리글 및 바닥글 가이드를 사용하여 흑백 문서에 전문적인 머리글과 바닥글을 추가하세요.
  • 페이지 번호 : 페이지 번호 매기기 튜토리얼을 따라 회색조 PDF에 페이지 번호를 추가하세요.
  • 워터마크 : 브랜드 홍보 또는 보안 목적으로 흑백 PDF에 워터마크를 적용할 수 있습니다.
  • PDF 압축 : 회색조 렌더링과 PDF 압축을 결합하여 파일 크기를 더욱 줄입니다.

흑백 PDF 생성을 위한 모범 사례

  1. 색상 대비 테스트 : 변환하기 전에 요소 간에 충분한 대비가 있는지 확인하십시오.
  2. 시맨틱 HTML 사용 : 잘 구조화된 HTML은 더 나은 회색조 변환 결과를 제공합니다.
  3. 접근성을 고려하세요 : 흑백 PDF는 시각 장애가 있는 사람들의 가독성을 향상시킬 수 있습니다.
  4. 제작 전 미리보기 : 대량 생산 전에 항상 흑백 출력물을 미리 확인하세요.

일반적인 문제 해결

흑백 PDF 생성에 문제가 발생하는 경우:

  1. 텍스트가 흐릿하게 보이는 경우 : 렌더링 옵션에서 적절한 DPI 설정을 사용하십시오.
  2. 이미지가 흐릿하게 보임 : 변환하기 전에 원본 이미지의 대비를 조정하십시오.
  3. 성능 문제 : 자주 생성되는 회색조 PDF 파일에 대한 캐싱을 구현합니다.

자세한 문제 해결 방법은 종합 문제 해결 가이드를 참조하세요.

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? PDF 변환 방법에 대한 튜토리얼 페이지는 여기에서 확인하세요.

자주 묻는 질문

C#에서 컬러 PDF를 흑백으로 변환하는 방법은 무엇인가요?

IronPDF를 사용하여 컬러 PDF를 회색조로 변환하려면 ChromePdfRenderer 객체를 생성하고 RenderingOptions의 GrayScale 속성을 true로 설정합니다. 그런 다음 RenderUrlAsPdf, RenderHtmlAsPdf 또는 RenderHtmlFileAsPdf와 같은 메서드를 사용하여 회색조 PDF 문서를 생성합니다.

RenderingOptions의 GrayScale 속성은 어떤 용도로 사용되나요?

IronPDF의 RenderingOptions에 있는 GrayScale 속성은 PDF의 모든 색상을 회색조로 변환합니다. 이 속성을 true로 설정하면 IronPDF의 Chrome 렌더링 엔진이 RGB 색상의 휘도 값을 자동으로 계산하고 시각적 계층 구조와 대비를 유지하면서 회색조 값으로 변환합니다.

컬러 PDF 대신 흑백 PDF를 사용해야 하는 이유는 무엇인가요?

IronPDF의 회색조 렌더링은 특히 대량 인쇄 작업과 같이 비용 효율적인 인쇄에 이상적입니다. 회색조 PDF는 원본 색상이 너무 밝을 때 가독성을 향상시키고, 다양한 장치 및 플랫폼과의 호환성을 높이며, 일관된 보기 환경을 제공합니다.

특정 페이지만 흑백으로 변환하고 나머지 페이지는 컬러로 유지할 수 있나요?

IronPDF를 사용하면 문서를 회색조로 렌더링한 다음 CopyPage와 같은 메서드를 사용하여 특정 페이지만 추출할 수 있습니다. GrayScale 속성을 활성화하면 전체 문서가 회색조로 렌더링되지만, 여러 렌더링 단계를 조합하여 색상과 회색조가 혼합된 문서를 만들 수도 있습니다.

어떤 유형의 콘텐츠를 흑백 PDF로 변환할 수 있나요?

IronPDF는 RenderUrlAsPdf를 통해 웹 페이지, RenderHtmlAsPdf를 통해 HTML 문자열, RenderHtmlFileAsPdf를 통해 HTML 파일 등 다양한 콘텐츠 유형을 회색조 PDF로 변환할 수 있습니다. 모든 콘텐츠 유형은 일관된 결과를 위해 동일한 회색조 렌더링 옵션을 지원합니다.

하릴 하시미 빈 오마르
하릴 하시미 빈 오마르
  지금 바로 엔지니어링 팀과 채팅하세요
소프트웨어 엔지니어
모든 훌륭한 엔지니어처럼, 하이릴은 열정적인 학습자입니다. 그는 C#, Python, Java에 대한 지식을 갈고닦아 Iron Software의 팀원들에게 가치를 더하고 있습니다. 하이릴은 말레이시아의 Universiti Teknologi MARA에서 화학 및 공정 공학 학사 학위를 취득한 후 Iron Software 팀에 합류했습니다.
시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다