Résultats inattendus de la compression bitonale en C#
IronPDF 2026.10.1+ introduit une compression binaire à activation volontaire, qui convertit les images éligibles en CCITT Groupe 4 1-bit via AdvancedCompressionOptions sur CompressAndSaveAs, couvert dans le guide de compression PDF. Configurer BitonalMode = Force peut entraîner trois symptômes : des images couleur transformées en noir et blanc, des scans qui semblent plus doux que l'original, ou aucun changement du tout.
Pourquoi mes images couleurs sont-elles en noir et blanc ?
BitonalMode = Force applique un seuil à chaque image éligible pour rendre du pur noir et blanc, quel que soit son contenu : les détails en couleur et en niveaux continus sont écartés et ne peuvent être restaurés.
Correction : laissez BitonalMode à Off pour les PDF avec des images couleur ou photographiques, et utilisez Force uniquement pour le texte scanné, les télécopies et les dessins en noir et blanc.
Pourquoi mon scan semble-t-il plus doux que l'original ?
Avec seulement BitonalMode = Force réglé, BitonalResolutionDpi reste null et revient à TargetImageDpi, qui par défaut est 150 : un scan à 300 DPI est échantillonné à 150 DPI avant l'application du seuil.
Correction : réglez BitonalResolutionDpi sur la résolution en DPI du scan, ou réglez TargetImageDpi = null pour appliquer le seuil à la résolution source. Régler BitonalResolutionDpi à 0 ne conserve pas la résolution source : il se comporte comme null.
var options = new AdvancedCompressionOptions();
options.BitonalMode = BitonalCompressionMode.Force;
options.BitonalResolutionDpi = 300; // Threshold at 300 DPI
pdf.CompressAndSaveAs("output.pdf", options);
Pourquoi la compression binaire n'a rien changé ?
La compression binaire ignore une image sans erreur dans ces cas:
- Le résultat CCITT n'était pas plus petit : l'image conserve son encodage actuel. La décision est prise par image, donc un document peut être partiellement converti
- L'image a un masque : une image avec un masque doux, pochoir ou avec clé de couleur conserve son encodage actuel, et le masque n'est ni supprimé ni aplati
- L'image est déjà en 1-bit : les scans existants en CCITT et JBIG2 sont laissés intacts
- Le PDF a été compressé en mémoire :
CompressPdfToBytesetCompressPdfToStreamn'acceptent pasAdvancedCompressionOptions, donc seulCompressAndSaveAspeut produire une sortie en CCITT Groupe 4
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.