Skip to content

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub

图像压缩设置

CPDFOptimizeImageOption 参数说明

CPDFOptimizeImageOption 类用于配置图像压缩的详细参数:

属性类型默认值说明
UperPpiint225上限 PPI(每英寸像素),高于此值的图像将被降采样
TargetPpiint150目标 PPI,降采样后的目标分辨率
CompAlgCPDF_COMP_ALGJPEG2000压缩算法
Qualityint40图像质量 (1-100)
BlockSizeint256数据块大小(字节)

CPDF_COMP_ALG 压缩算法说明

算法说明适用场景
COMP_ALG_JPEG20001JPEG 2000 压缩高质量彩色图像,支持无损和有损压缩
COMP_ALG_JPEG2标准 JPEG 压缩照片和彩色图像,兼容性最好
COMP_ALG_JBIG23JBIG2 压缩扫描文档和黑白图像
COMP_ALG_CCITT44CCITT Group 4 压缩单色图像,传真文档
COMP_ALG_CCITT35CCITT Group 3 压缩传真图像,单色位图

配置图像压缩选项

c#
// 创建图像优化选项
CPDFOptimizeImageOption imageOption = new CPDFOptimizeImageOption();
imageOption.UperPpi = 300;                              // 高于 300 PPI 的图像将被降采样
imageOption.TargetPpi = 150;                            // 降采样目标为 150 PPI
imageOption.CompAlg = CPDF_COMP_ALG.COMP_ALG_JPEG;      // 使用 JPEG 压缩
imageOption.Quality = 60;                               // 图像质量 60%
imageOption.BlockSize = 256;                            // 块大小 256 字节

// 应用图像选项
optimizeOption.SetImageOption(imageOption);

// 获取当前图像选项
CPDFOptimizeImageOption currentImageOption = optimizeOption.GetImageOption();
Console.WriteLine($"当前压缩算法: {currentImageOption.CompAlg}");
Console.WriteLine($"当前图像质量: {currentImageOption.Quality}");

快速设置图像质量

如果只需要调整图像质量,可以使用快捷方法:

c#
// 设置图像质量 (1-100)
optimizeOption.SetImageQuality(75.0f);

// 获取当前图像质量
float quality = optimizeOption.GetImageQuality();
Console.WriteLine($"当前图像质量: {quality}");