Cómo generar PDF en escala de grises en C#

¿Por qué establecer la escala de grises en verdadero convierte los colores?

Un PDF en escala de grises es un documento en el que todos los colores y matices se representan utilizando tonos de gris en lugar de la gama completa de colores. Al activar la opción de escala de grises, el motor de renderizado Chrome de IronPDF convierte automáticamente todos los valores de color RGB a sus correspondientes equivalentes en escala de grises mediante cálculos de luminancia estándar del sector. Esto garantiza que se conserven la jerarquía visual y el contraste del documento original, al tiempo que se elimina toda la información de color.

¿Cuándo debo utilizar PDF en escala de grises?

IronPDF muestra los documentos PDF en escala de grises en lugar de en color. Imprimir documentos PDF en escala de grises es rentable para impresiones en lotes grandes. La representación en escala de grises mejora la legibilidad cuando los colores originales son excesivamente brillantes o vibrantes. Los PDF en escala de grises son más compatibles con distintos dispositivos, programas y plataformas, lo que garantiza una experiencia de visualización e impresión coherente.

Los casos de uso más comunes para los PDF en escala de grises son:

• Informes empresariales: Los documentos financieros suelen tener un aspecto más profesional en escala de grises
• Documentos jurídicos: Los expedientes judiciales y los escritos jurídicos suelen requerir un formato en escala de grises
• Trabajos académicos: Los trabajos de investigación y las disertaciones suelen imprimirse en escala de grises
• Impresión de gran volumen: La escala de grises reduce los costes al imprimir cientos de páginas
• Documentos de archivo: ideal para el almacenamiento a largo plazo y cumplimiento de la normativa PDF/A

¿Qué le ocurre al texto cuando se convierte a escala de grises?

La implementación actual de la función Escala de grises convierte el texto del documento PDF renderizado en una imagen, por lo que el método ExtractAllImages no genera ningún texto.

Actualmente, esta funcionalidad solo está disponible al renderizar PDFs. Es posible que futuras actualizaciones incluyan la posibilidad de convertir documentos PDF existentes a escala de grises. Para obtener más información sobre cómo trabajar con la extracción de texto, consulte nuestra guía sobre Extracción de texto e imágenes.

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

Convertir archivos HTML en PDF en escala de grises

Cuando trabajes con archivos HTML locales, puedes convertirlos a PDF en escala de grises. Esto resulta útil cuando se dispone de plantillas o informes prediseñados que necesitan una representación sin color. Más información sobre convertir archivos HTML a 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");

Creación de archivos PDF en escala de grises a partir de cadenas HTML

Para la generación de contenidos dinámicos, convierta cadenas HTML directamente en PDF en escala de grises. Este enfoque funciona bien para generar facturas, recibos o cualquier documento cuyo contenido se cree mediante programación. Para más detalles, visite nuestra guía sobre Conversión de cadenas HTML a 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");