C# 中二值压缩的意外结果

Curtis Chau
Curtis Chau
更新: 2026年10月12日

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);
C#

为什么二值化压缩什么都没改变?

在以下情况下,二值化压缩会跳过图像且不出现错误:

  • CCITT结果并没有变小:图像保持其当前编码。 决定是针对每个图像做出的,因此文档可能会部分转换
  • 图像有遮罩:具有软性、模板或色键遮罩的图像保持其当前编码,且遮罩既不会被丢弃也不会被展平
  • 图像已经是1位:现有CCITT和JBIG2扫描将保持不变
  • PDF是在内存中压缩的:CompressPdfToBytes和CompressPdfToStream不接受AdvancedCompressionOptions,因此只有CompressAndSaveAs能生成CCITT第4组输出

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

NuGet 下载量 22,198,312版本:2026.11刚刚发布