1. IronPDF
  2. Poradniki
  3. Skala szarości
Jak generować pliki PDF w skali szarości w języku C#

Jak wygenerować PDF w skali szarości w C

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Zaktualizowano:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF umożliwia renderowanie PDFów w odcieniach szarości przez ustawienie właściwości GrayScale na true w RenderingOptions, konwertując kolorową zawartość na odcienie szarości dla ekonomicznego wydruku i lepszej czytelności.

Szybki start: Konwersja kolorowych PDF-ów na skalę szarości przy użyciu IronPDF

Przekształć kolorowe PDF-y w skalę szarości przy użyciu IronPDF za pomocą kilku linii kodu. Ustaw właściwość GrayScale w RenderingOptions, aby renderować strony internetowe lub zawartość HTML do PDFów w odcieniach szarości. Ten przewodnik pokazuje, jak generować dokumenty w skali szarości dla spójnej wizualizacji.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

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

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Pobierz bibliotekę IronPDF do renderowania PDF-ów w skali szarości
  2. Utwórz instancję klasy ChromePdfRenderer
  3. Ustaw właściwość GrayScale opcji RenderingOptions na true
  4. Uzyskaj dostęp i renderuj dokument PDF z URL, ciągu HTML lub pliku
  5. Wyeksportuj dokument PDF w skali szarości do żądanej lokalizacji


Jak wygenerować PDF w skali szarości?

Aby wygenerować PDF w odcieniach szarości, ustaw właściwość GrayScale obiektu RenderingOptions na true. Ta funkcja jest częścią kompleksowych opcji renderowania IronPDF, które dają dokładną kontrolę nad wyjściem PDF.

W dostarczonym fragmencie kodu funkcja odcieni szarości jest włączona po zainicjowaniu ChromePdfRenderer. Następnie renderuje stronę internetową, używając metody RenderUrlAsPdf. Kod również wyodrębnia tylko pierwszą stronę zrenderowanego PDF-a i zapisuje ją lokalnie. Jeśli jesteś nowy w IronPDF, zapoznaj się z naszym przewodnikiem szybkiego startu, aby zapoznać się z podstawami.

Dlaczego ustawienie GrayScale na True konwertuje kolory?

PDF w skali szarości to dokument, w którym wszystkie kolory i odcienie są reprezentowane za pomocą odcieni szarości zamiast pełnego spektrum kolorów. Gdy włączysz opcję GrayScale, silnik renderujący Chrome IronPDF automatycznie konwertuje wszystkie wartości kolorów RGB na ich odpowiedniki w odcieniach szarości, używając kalkulacji luminancji standardowej w branży. To zapewnia, że hierarchia wizualna i kontrast oryginalnego dokumentu są zachowane przy jednoczesnym usunięciu wszystkich informacji o kolorze.

Kiedy powinienem używać PDF-ów w skali szarości?

IronPDF renderuje dokumenty PDF w skali szarości zamiast koloru. Drukowanie dokumentów PDF w skali szarości jest bardziej ekonomiczne przy druku dużych partii. Renderowanie w skali szarości poprawia czytelność, gdy oryginalne kolory są nadmiernie jasne lub jaskrawe. PDF-y w skali szarości mają zwiększoną kompatybilność na różnych urządzeniach, oprogramowaniu i platformach, zapewniając spójne wrażenia podczas oglądania i drukowania.

Typowe zastosowania dla PDF-ów w skali szarości obejmują:

  • Raporty biznesowe: Dokumenty finansowe często wyglądają bardziej profesjonalnie w skali szarości
  • Dokumenty prawne: Akta sądowe i pisma procesowe zazwyczaj wymagają formatowania w skali szarości
  • Prace akademickie: Prace badawcze i rozprawy często drukuje się w skali szarości
  • Drukowanie wielko-skalowe: Skala szarości obniża koszty przy drukowaniu setek stron
  • Dokumenty archiwalne: Idealne do długoterminowego przechowywania i zgodności z PDF/A

Co dzieje się z tekstem podczas konwersji na skalę szarości?

Obecna implementacja funkcji Odcieni Szarości konwertuje tekst w renderowanym dokumencie PDF na obraz, co skutkuje tym, że metoda ExtractAllImages nie generuje żadnego tekstu.

Obecnie ta funkcjonalność jest dostępna tylko podczas renderowania PDF-ów. Przyszłe aktualizacje mogą obejmować możliwość konwersji istniejących dokumentów PDF na skalę szarości. Więcej informacji o pracy z wyodrębnianiem tekstu znajdziesz w naszym przewodniku Wyodrębnianie tekstu i obrazów.

: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");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Set GrayScale to true
renderer.RenderingOptions.GrayScale = True

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://ironsoftware.com/")
pdf.CopyPage(0).SaveAs("test.pdf")
$vbLabelText   $csharpLabel
Icon Quote related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku
Icon Quote related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku
Icon Quote related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones related to Co dzieje się z tekstem podczas konwersji na skalę szarości?

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Zaawansowane przykłady generowania PDF-ów w skali szarości

Konwersja plików HTML na PDF-y w skali szarości

Pracując z lokalnymi plikami HTML, możesz konwertować je na PDF-y w skali szarości. Jest to przydatne, gdy masz zaprojektowane wcześniej szablony lub raporty, które wymagają renderowania bez koloru. Dowiedz się więcej o konwersji plików HTML na PDF.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-3.cs
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");

Imports IronPdf

' Create a renderer with grayscale enabled
Dim renderer As New ChromePdfRenderer() With {
    .RenderingOptions = New ChromePdfRenderOptions() With {
        .GrayScale = True,
        .MarginTop = 50,
        .MarginBottom = 50,
        .MarginLeft = 20,
        .MarginRight = 20
    }
}

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

Tworzenie PDF-ów w skali szarości z ciągów HTML

Dla dynamicznego generowania treści, konwertuj ciągi HTML bezpośrednio na PDF-y w skali szarości. Podejście to dobrze działa przy generowaniu faktur, rachunków lub dowolnych dokumentów, gdzie treść jest tworzona programowo. Więcej szczegółów można znaleźć w naszym przewodniku o konwersji ciągów HTML na PDF.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-4.cs
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");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.GrayScale = True

' HTML content with inline CSS
Dim htmlContent As String = "
    <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>"

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

Kwestie związane z wydajnością

Tworząc PDF-y w skali szarości, weź pod uwagę te czynniki wydajności:

  1. Rozmiar pliku: PDF-y w skali szarości są mniejsze niż wersje kolorowe, idealne jako załączniki do e-maili i do pobrań z sieci
  2. Szybkość renderowania: Konwersja na skalę szarości dodaje minimalne obciążenie do czasu renderowania
  3. Użycie pamięci: Renderowanie w skali szarości wykorzystuje mniej pamięci niż renderowanie pełnokolorowe, co jest korzystne dla dużych dokumentów

Dla lepszej wydajności przy generowaniu wielu PDF-ów w skali szarości użyj technik asynchronicznych i wielowątkowych.

Integracja z innymi funkcjami IronPDF

Połącz PDF-y w skali szarości z innymi funkcjami IronPDF dla kompleksowego przetwarzania dokumentów:

  • Nagłówki i stopki: Dodaj profesjonalne nagłówki i stopki do swoich dokumentów w skali szarości, korzystając z naszego przewodnika nagłówki i stopki
  • Numery stron: Dodaj numerację stron w swoich PDF-ach w skali szarości, postępując zgodnie z naszym samouczkiem o numerach stron
  • Znak wodny: Zastosuj znaki wodne do PDF-ów w skali szarości dla branding lub bezpieczeństwa
  • Kompresja PDF: Zmniejsz rozmiar plików jeszcze bardziej, łącząc renderowanie w skali szarości z kompresją PDF

Najlepsze praktyki generowania PDF-ów w skali szarości

  1. Testuj kontrast kolorów: Zapewnij wystarczający kontrast między elementami przed konwersją
  2. Używaj semantycznego HTML: Dobrze zbudowany HTML zapewnia lepsze wyniki konwersji na skalę szarości
  3. Zastanów się nad dostępnością: PDF-y w skali szarości mogą poprawić czytelność dla niektórych zaburzeń wzroku
  4. Podgląd przed produkcją: Zawsze dokonuj podglądu wyjścia w skali szarości przed generowaniem dużych partii

Rozwiązywanie typowych problemów

Jeśli napotkasz problemy z generowaniem PDF-ów w skali szarości:

  1. Tekst wygląda nieczytelnie: Użyj odpowiednich ustawień DPI w opcjach renderowania
  2. Obrazy wyglądają na wyprane: Dostosuj kontrast źródłowego obrazu przed konwersją
  3. Problemy z wydajnością: Zastosuj buforowanie dla często generowanych PDF-ów w skali szarości

Aby uzyskać szczegółowe informacje na temat rozwiązywania problemów, odwiedź nasz kompleksowy przewodnik rozwiązywania problemów.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Konwersja PDF-ów

Często Zadawane Pytania

Jak przekonwertowac kolorowy PDF na odcienie szarosci w C#?

Aby przekonwertowac kolorowy PDF na odcienie szarosci uzywajac IronPDF, stworz obiekt ChromePdfRenderer i ustaw wlasciwosc GrayScale w RenderingOptions na true. Nastepnie uzyj metod takich jak RenderUrlAsPdf, RenderHtmlAsPdf lub RenderHtmlFileAsPdf, aby wygenerowac swoj dokument PDF w odcieniach szarosci.

Jaki jest cel wlasciwosci GrayScale w RenderingOptions?

Wlasciwosc GrayScale w RenderingOptions IronPDF konwertuje wszystkie kolory w twoim PDF na odcienie szarosci. Kiedy jest ustawiona na true, silnik renderujacy Chrome IronPDF automatycznie oblicza wartosci luminancji kolorow RGB i konwertuje je na ich odpowiedniki w odcieniach szarosci, zachowujac hierarchie wizualna i kontrast.

Dlaczego powinnam uzywac PDFow w odcieniach szarosci zamiast kolorowych?

Renderowanie w odcieniach szarosci w IronPDF jest idealne do oszczednego drukowania, szczegolnie dla duzych operacji masowych. PDFy w odcieniach szarosci rowniez poprawiaja czytelnosc, gdy oryginalne kolory sa zbyt jasne, zapewniaja lepsza kompatybilnosc na roznych urzadzeniach i platformach oraz oferuja spojne doswiadczenia wizualne.

Czy moge konwertowac konkretne strony na odcienie szarosci, pozostawiajac inne w kolorze?

Z IronPDF mozesz renderowac dokumenty w odcieniach szarosci, a potem wyodrebnic konkretne strony uzywajac metod takich jak CopyPage. Chociaz caly dokument jest renderowany w odcieniach szarosci, kiedy wlasciwosc GrayScale jest wlaczona, mozesz laczyc rozne podejscia renderowania, aby tworzyc dokumenty z mieszana zawartoscia kolorowa i w odcieniach szarosci.

Jakie typy tresci mozna konwertowac na PDFy w odcieniach szarosci?

IronPDF moze konwertowac rozne typy tresci na PDFy w odcieniach szarosci, w tym strony internetowe poprzez RenderUrlAsPdf, ciagi HTML za pomoca RenderHtmlAsPdf i pliki HTML poprzez RenderHtmlFileAsPdf. Wszystkie typy tresci wspieraja opcje renderowania GrayScale dla spojnych rezultatow.

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  Czat z zespołem inżynierów teraz
Inżynier oprogramowania
Jak wszyscy wielcy inżynierowie, Hairil jest zapalonym uczniem. Doskonali swoją wiedzę na temat C#, Pythona i Javy, wykorzystując tę wiedzę, aby dodawać wartości członkom zespołu Iron Software. Hairil dołączył do zespołu Iron Software z Universiti Teknologi MARA w Malezji, gdzie uzyskał tytuł licencjata ...
Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 19,936,792 | Wersja: 2026.7 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.