C# 中二值压缩的意外结果
IronPDF 2026.10.1+ 引入了选择性加入的二值化压缩,通过AdvancedCompressionOptions在CompressAndSaveAs将符合条件的图像转换为1位CCITT 第4组,详见PDF压缩指南。 设置BitonalMode = Force可能导致三个症状:彩色图像变成黑白,扫描看起来比原件更柔和,或者没有任何变化。
为什么我的彩色图像变成了黑白?
BitonalMode = Force将每个符合条件的图像阈值化为纯黑白,无论其包含什么:彩色和连续色调细节将被丢弃且无法恢复。
解决方法:将BitonalMode保持在Off,用于包含彩色或摄影图像的PDF,仅在扫描文本、传真和线条画中使用Force。
为什么我的扫描看起来比原件更柔和?
仅设置BitonalMode = Force,BitonalResolutionDpi保持null并回退到TargetImageDpi,默认为150:300 DPI扫描在阈值化之前会降采样到150 DPI。
解决方法:将BitonalResolutionDpi设置为扫描的DPI,或设置TargetImageDpi = null以在源分辨率下进行阈值化。 将BitonalResolutionDpi设置为0不会保留源分辨率:其表现得像null。
var options = new AdvancedCompressionOptions();
options.BitonalMode = BitonalCompressionMode.Force;
options.BitonalResolutionDpi = 300; // Threshold at 300 DPI
pdf.CompressAndSaveAs("output.pdf", options);
为什么二值化压缩什么都没改变?
在以下情况下,二值化压缩会跳过图像且不出现错误:
- CCITT结果并没有变小:图像保持其当前编码。 决定是针对每个图像做出的,因此文档可能会部分转换
- 图像有遮罩:具有软性、模板或色键遮罩的图像保持其当前编码,且遮罩既不会被丢弃也不会被展平
- 图像已经是1位:现有CCITT和JBIG2扫描将保持不变
- PDF是在内存中压缩的:
CompressPdfToBytes和CompressPdfToStream不接受AdvancedCompressionOptions,因此只有CompressAndSaveAs能生成CCITT第4组输出
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。