Comment générer des fichiers PDF en niveaux de gris en C#

Comment générer un PDF en niveaux de gris en C#35;

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF vous permet de rendre les PDF en niveaux de gris en définissant la propriété GrayScale sur true dans RenderingOptions, convertissant le contenu couleur en nuances de gris pour une impression rentable et une meilleure lisibilité.

Démarrage rapide : Convertir des PDFs couleur en niveaux de gris avec IronPDF

Transformez les PDF couleur en niveaux de gris à l'aide d'IronPDF avec seulement quelques lignes de code. Définissez la propriété GrayScale dans les RenderingOptions pour rendre les pages web ou le contenu HTML en PDF en niveaux de gris. Ce guide vous montre comment générer des documents en niveaux de gris pour un affichage cohérent.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    var renderer = new IronPdf.ChromePdfRenderer();
    renderer.RenderingOptions.GrayScale = true;
    var pdf = renderer.RenderUrlAsPdf("https://example.com");
    pdf.SaveAs("grayscale.pdf");
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer


Comment générer un PDF en niveaux de gris?

Pour générer un PDF en niveaux de gris, définissez la propriété GrayScale du RenderingOptions sur true. Cette fonctionnalité fait partie des options de rendu complètes d'IronPDF qui vous permettent de contrôler finement la sortie des PDF.

Dans l'extrait de code fourni, la fonction d'échelle de gris est activée après l'instanciation d'un ChromePdfRenderer. Elle rend ensuite une page web à l'aide de la méthode RenderUrlAsPdf. Le code n'extrait que la première page du PDF rendu et l'enregistre localement. Si vous ne connaissez pas encore IronPDF, consultez notre Guide de démarrage rapide pour vous familiariser avec les principes de base.

Pourquoi le réglage de l'échelle de gris sur True permet-il de convertir les couleurs ?

Un PDF en niveaux de gris est un document dans lequel toutes les couleurs et nuances sont représentées par des tons de gris au lieu du spectre complet des couleurs. Lorsque vous activez l'option niveaux de gris, le moteur de rendu Chrome d'IronPDF convertit automatiquement toutes les valeurs de couleur RVB en leurs équivalents correspondants en niveaux de gris en utilisant les calculs de luminance standard de l'industrie. La hiérarchie visuelle et le contraste de votre document original sont préservés tout en supprimant toutes les informations relatives à la couleur.

Quand dois-je utiliser des PDF en niveaux de gris ?

IronPdf rend les documents PDF en niveaux de gris plutôt qu'en couleur. Imprimer des documents PDF en niveaux de gris est rentable pour l'impression en grande quantité. Le rendu en niveaux de gris améliore la lisibilité lorsque les couleurs d'origine sont excessivement vives ou éclatantes. Les PDF en niveaux de gris sont plus compatibles avec les appareils, les logiciels et les plateformes, ce qui garantit des expériences de visualisation et d'impression cohérentes.

Les cas d'utilisation courants des PDF en niveaux de gris sont les suivants :

  • Rapports d'activité : Les documents financiers ont souvent un aspect plus professionnel en niveaux de gris
  • Documents juridiques : Les documents déposés au tribunal et les mémoires juridiques nécessitent généralement un formatage en niveaux de gris
  • Documents universitaires : Les documents de recherche et les thèses sont généralement imprimés en niveaux de gris
  • Impression à haut volume : Les niveaux de gris réduisent les coûts lors de l'impression de centaines de pages
  • Documents d'archives : Idéal pour le stockage à long terme et conformité PDF/A

Qu'advient-il du texte lors de la conversion en niveaux de gris?

L'implémentation actuelle de la fonction Niveaux de gris convertit le texte du document PDF rendu en une image, ce qui fait que la méthode ExtractAllImages ne produit aucun texte.

Actuellement, cette fonctionnalité est uniquement disponible lors du rendu de PDFs. Les futures mises à jour pourraient inclure la possibilité de convertir les documents PDF existants en niveaux de gris. Pour plus d'informations sur le travail avec l'extraction de texte, consultez notre guide sur L'extraction de texte et d'images.

<TODO : Ajouter une image ici -->

: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

Exemples avancés de génération de PDF en niveaux de gris

Conversion de fichiers HTML en PDF à niveaux de gris

Lorsque vous travaillez avec des fichiers HTML locaux, vous pouvez les convertir en PDF en niveaux de gris. Cela est utile lorsque vous avez des modèles ou des rapports préconçus qui nécessitent un rendu sans couleur. En savoir plus sur la conversion de fichiers HTML en 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

Création de PDF en niveaux de gris à partir de chaînes HTML

Pour la génération de contenu dynamique, convertissez les chaînes HTML directement en PDF à niveaux de gris. Cette approche fonctionne bien pour générer des factures, des reçus ou tout autre document dont le contenu est créé par programmation. Pour plus de détails, consultez notre guide sur la conversion de chaînes HTML en 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

<TODO : Ajouter une image ici -->

Considérations de Performance

Lorsque vous générez des PDF en niveaux de gris, tenez compte des facteurs de performance suivants :

  1. <Taille du fichier : Les PDF en niveaux de gris sont plus petits que les versions en couleur, ce qui est idéal pour les pièces jointes aux courriels et les téléchargements sur le web
  2. Vitesse de rendu : La conversion en niveaux de gris n'ajoute qu'une surcharge minimale au temps de rendu
  3. Utilisation de la mémoire : Le rendu en niveaux de gris utilise moins de mémoire que le rendu en couleurs, ce qui est avantageux pour les documents volumineux

Pour de meilleures performances lors de la génération de plusieurs PDF en niveaux de gris, utilisez les techniques async et multithreading.

Intégration avec d'autres fonctionnalités d'IronPDF

Combinez les PDF à niveaux de gris avec d'autres fonctionnalités d'IronPDF pour un traitement complet des documents :

  • <En-têtes et pieds de page : Ajoutez des en-têtes et des pieds de page professionnels à vos documents en niveaux de gris à l'aide de notre guide des en-têtes et pieds de page
  • Numéros de page : incluez la numérotation des pages dans vos PDF en niveaux de gris en suivant notre tutoriel sur les numéros de page
  • <Filigranes : Appliquez des filigranes aux PDF en niveaux de gris pour les marquer ou les sécuriser
  • Compression PDF : Réduisez encore la taille des fichiers en combinant le rendu des niveaux de gris avec la compression PDF

Bonnes pratiques pour la génération de PDF en niveaux de gris

  1. Tester le contraste des couleurs : assurez-vous que le contraste entre les éléments est suffisant avant de procéder à la conversion
  2. Utiliser un HTML sémantique : Un HTML bien structuré produit de meilleurs résultats de conversion en niveaux de gris
  3. <Pensez à l'accessibilité : Les PDF en niveaux de gris peuvent améliorer la lisibilité pour certaines déficiences visuelles
  4. Visionner avant de produire : Prévisualisez toujours la sortie en niveaux de gris avant de générer des lots importants

Résolution des problèmes courants

Si vous rencontrez des problèmes avec la génération de PDF en niveaux de gris :

  1. Le texte semble flou : Utilisez les paramètres DPI appropriés dans vos options de rendu
  2. Les images sont délavées : Ajustez le contraste de l'image source avant la conversion
  3. Performance Issues : Implémentation de la mise en cache pour les PDF à niveaux de gris fréquemment générés

Pour un dépannage détaillé, consultez notre guide de dépannage complet.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriels ici : Convertir les PDFs

Questions Fréquemment Posées

Comment convertir un PDF couleur en niveaux de gris en C# ?

Pour convertir un PDF couleur en niveaux de gris à l'aide d'IronPdf, instanciez un objet ChromePdfRenderer et définissez la propriété GrayScale dans RenderingOptions sur true. Utilisez ensuite des méthodes telles que RenderUrlAsPdf, RenderHtmlAsPdf ou RenderHtmlFileAsPdf pour générer votre document PDF en niveaux de gris.

À quoi sert la propriété GrayScale dans RenderingOptions ?

La propriété GrayScale des options de rendu d'IronPDF convertit toutes les couleurs de votre PDF en nuances de gris. Lorsqu'elle est définie sur true, le moteur de rendu Chrome d'IronPDF calcule automatiquement les valeurs de luminance des couleurs RVB et les convertit en leurs équivalents en niveaux de gris tout en préservant la hiérarchie visuelle et le contraste.

Pourquoi devrais-je utiliser des PDF en niveaux de gris plutôt que des PDF en couleur ?

Le rendu en niveaux de gris d'IronPDF est idéal pour une impression rentable, en particulier pour les opérations par lots importants. Les PDF en niveaux de gris améliorent également la lisibilité lorsque les couleurs d'origine sont trop vives, garantissent une meilleure compatibilité entre les différents appareils et plateformes, et offrent des expériences de visualisation cohérentes.

Puis-je convertir certaines pages en niveaux de gris tout en conservant les autres en couleur ?

Avec IronPDF, vous pouvez rendre des documents en niveaux de gris, puis extraire des pages spécifiques à l'aide de méthodes telles que CopyPage. Bien que le document entier soit rendu en niveaux de gris lorsque la propriété GrayScale est activée, vous pouvez combiner différentes passes de rendu pour créer des documents mixtes en couleur et en niveaux de gris.

Quels types de contenu peuvent être convertis en PDF à niveaux de gris ?

IronPDF peut convertir divers types de contenu en PDF à niveaux de gris, notamment des pages web via RenderUrlAsPdf, des chaînes HTML via RenderHtmlAsPdf et des fichiers HTML à l'aide de RenderHtmlFileAsPdf. Tous les types de contenu prennent en charge la même option de rendu en niveaux de gris pour des résultats cohérents.

Hairil Hasyimi Bin Omar
Ingénieur logiciel
Comme tous les grands ingénieurs, Hairil est un apprenant avide. Il affine ses connaissances en C#, Python et Java, utilisant ces connaissances pour apporter de la valeur aux membres de l'équipe dans toute Iron Software. Hairil a rejoint l'équipe d'Iron Software depuis l'Université Teknologi MARA en Malaisie, ...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir