2026-02-13 -> keep.

Tested With: GroupDocs.Redaction 23.11 for Java -> keep.

Author: GroupDocs -> keep.

Now produce final markdown with translations.

Make sure to keep code block placeholders unchanged.

Let’s craft final answer.# GroupDocs.Redaction Java : Guide de rasterisation en niveaux de gris

Introduction

Si vous devez create grayscale pdf tout en gardant vos documents sécurisés et d’aspect professionnel, vous êtes au bon endroit. Dans ce tutoriel, nous parcourrons les étapes exactes pour convertir des fichiers DOCX, PDF ou autres fichiers pris en charge, colorés, en une version propre, rasterisée en niveaux de gris à l’aide de GroupDocs.Redaction pour Java. Vous apprendrez pourquoi la rasterisation ajoute une couche de sécurité supplémentaire, comment configurer la bibliothèque et comment gérer les ressources efficacement — le tout dans un style conversationnel, étape par étape.

Réponses rapides

  • What does grayscale rasterization do? Elle convertit chaque page d’un document en une image haute résolution puis applique un filtre en niveaux de gris, supprimant toutes les informations de couleur.
  • Why use GroupDocs.Redaction for this? Elle combine la sécurité de la rédaction avec des options de rasterisation puissantes dans une seule API.
  • Which formats are supported? DOCX, PDF, XLSX, PPTX, RTF et bien d’autres.
  • Do I need a license? Une licence valide GroupDocs.Redaction est requise pour une utilisation en production ; un essai est disponible pour les tests.
  • What Java version is required? JDK 8 ou supérieur.

Qu’est-ce que create grayscale pdf ?

Créer un PDF en niveaux de gris signifie convertir chaque élément visuel du document original en nuances de gris. Le résultat est un fichier plus petit, adapté à l’impression, qui élimine les distractions liées aux couleurs et apporte un léger avantage de sécurité puisque le contenu devient basé sur des images.

Pourquoi utiliser la rasterisation en niveaux de gris avec GroupDocs.Redaction ?

  • Sécurité renforcée – les pages rasterisées ne peuvent pas être sélectionnées, copiées ou modifiées en tant que texte.
  • Aspect cohérent – les couleurs sont supprimées, offrant un rendu uniforme et professionnel.
  • Large prise en charge des formats – la même API fonctionne pour DOCX, PDF, PPTX, etc.
  • Contrôle fin – vous pouvez ajuster le DPI, le format de sortie et des options avancées telles que la conversion en niveaux de gris.

Prérequis

  • Java Development Kit (JDK) 8 ou plus récent. Vérifiez avec java -version.
  • Un IDE (IntelliJ IDEA, Eclipse ou NetBeans) pour faciliter le codage et le débogage.
  • GroupDocs.Redaction pour Java ajouté via Maven ou Gradle.
  • Un document d’exemple (par ex. un DOCX multi‑pages) sur lequel vous pouvez expérimenter en toute sécurité.
  • Un espace disque suffisant pour la sortie rasterisée (les fichiers raster peuvent être plus volumineux que la source).

Importer les packages

Configurer les bonnes importations, c’est comme organiser votre boîte à outils avant un projet. Les importations suivantes vous donnent accès à la classe principale Redactor et aux options de rasterisation dont nous aurons besoin.

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.RasterizationOptions;
import com.groupdocs.redaction.options.AdvancedRasterizationOptions;

Étape 1 : Initialiser l’objet Redactor

Créer une instance Redactor ouvre la porte à toutes les capacités de traitement de documents.

final Redactor redactor = new Redactor(Constants.MULTIPAGE_SAMPLE_DOCX);

Remplacez Constants.MULTIPAGE_SAMPLE_DOCX par le chemin du fichier que vous souhaitez convertir en PDF en niveaux de gris.

Étape 2 : Configurer les options d’enregistrement

SaveOptions définit comment le fichier final sera écrit. Ajouter un suffixe vous aide à conserver le fichier original intact.

SaveOptions so = new SaveOptions();
so.setRedactedFileSuffix("_scan");

Le fichier de sortie sera nommé yourfile_scan.docx (ou le format que vous spécifierez plus tard).

Étape 3 : Activer la rasterisation

Activer la rasterisation indique au moteur de rendre chaque page sous forme d’image avant l’enregistrement.

so.getRasterization().setEnabled(true);

La rasterisation est la base de la création d’un PDF en niveaux de gris car elle convertit le document en une représentation basée sur des images.

Étape 4 : Appliquer la conversion en niveaux de gris

Nous ajoutons maintenant le filtre en niveaux de gris à la chaîne de rasterisation.

so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Grayscale);

Cette option force chaque pixel à être rendu en nuances de gris, vous donnant le résultat create grayscale pdf recherché.

Étape 5 : Exécuter la transformation du document

L’appel save exécute toute la chaîne de traitement.

redactor.save(so);

Après l’exécution de cette ligne, vous trouverez un nouveau fichier sur le disque, entièrement rasterisé, en niveaux de gris, et enregistré avec le suffixe _scan.

Étape 6 : Gestion correcte des ressources

Nettoyer les ressources évite les verrous de fichiers et les fuites de mémoire.

finally { redactor.close(); }

Pour les versions modernes de Java, vous pouvez également utiliser le modèle try‑with‑resources, qui ferme automatiquement le Redactor :

try (Redactor redactor = new Redactor(Constants.MULTIPAGE_SAMPLE_DOCX)) {
    // Your processing code here
}
// Automatic cleanup happens here

Les deux approches sont sûres ; la seconde est plus concise.

Options de configuration avancées

Ajuster le DPI pour la qualité ou la taille

Un DPI plus élevé produit des images plus nettes (idéal pour l’impression), tandis qu’un DPI plus bas réduit la taille du fichier.

saveOptions.getRasterization().setDpi(300); // High quality for printing
// or
saveOptions.getRasterization().setDpi(150); // Balanced quality and size

Choisir un format de sortie

Vous pouvez forcer le résultat rasterisé dans un format de conteneur spécifique, tel que PDF.

saveOptions.setRasterizationFormat(RasterizationFormat.PDF);

Cas d’utilisation courants

  • Archivage de documents juridiques – créer des PDF en niveaux de gris immuables qui ne peuvent pas être modifiés.
  • Rapports prêts à imprimer – garantir une sortie noir et blanc cohérente pour l’impression en masse.
  • Flux de travail de conformité – combiner la rédaction avec la rasterisation en niveaux de gris pour répondre aux réglementations strictes de protection des données.

Problèmes courants et solutions

ProblèmePourquoi cela se produitSolution
Le fichier de sortie est plus volumineux que prévuDPI trop élevé ou compression d’image désactivéeRéduire le DPI (par ex. 150) ou activer la compression dans RasterizationOptions.
Le texte apparaît flouDPI insuffisant pour la taille de police d’origineAugmenter le DPI à 300 ou plus.
Le processus lance OutOfMemoryError sur de gros documentsLe document entier est chargé en mémoireUtiliser les API de streaming ou traiter les pages par lots si supporté.
Le niveau de gris n’est pas appliquéOption avancée non ajoutée correctementVérifier que addAdvancedOption(AdvancedRasterizationOptions.Grayscale) est appelé avant save().

Questions fréquemment posées

Q : Puis‑je convertir des documents en niveaux de gris sans rasterisation ?
R : Dans GroupDocs.Redaction, l’option de niveaux de gris est liée à la rasterisation, ce qui garantit des résultats cohérents et ajoute de la sécurité.

Q : Quels formats de documents prennent en charge la rasterisation en niveaux de gris ?
R : Tous les formats majeurs supportés par GroupDocs.Redaction — y compris DOCX, PDF, XLSX, PPTX, RTF et plus — peuvent être rasterisés et convertis en niveaux de gris.

Q : La rasterisation affectera‑t‑elle la taille de mes fichiers ?
R : Oui. Les fichiers très textuels peuvent augmenter, tandis que les fichiers très graphiques peuvent diminuer. Les réglages de DPI ont l’impact le plus important.

Q : Est‑il possible d’inverser le processus de rasterisation en niveaux de gris ?
R : Non. La rasterisation est un processus à sens unique ; conservez une copie de sauvegarde de l’original si vous devez revenir en arrière.

Q : Comment optimiser la qualité des documents rasterisés en niveaux de gris ?
R : Utilisez un DPI plus élevé (300 + pour la qualité d’impression) et choisissez un format de sortie approprié (PDF est courant pour l’archivage).

Conclusion

Vous disposez maintenant d’une recette complète, prête pour la production, afin de create grayscale pdf à l’aide de GroupDocs.Redaction pour Java. En activant la rasterisation, en ajoutant l’option avancée de niveaux de gris et en gérant les ressources de façon responsable, vous pouvez produire des documents sécurisés, adaptés à l’impression, qui répondent aux exigences de conformité.

Last Updated: 2026-02-13
Tested With: GroupDocs.Redaction 23.11 for Java
Author: GroupDocs