Skip to content

PDF 生成模板编辑器

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

查看 GitHub

图像压缩设置

CPDFOptimizeImageOption 参数说明

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

属性类型默认值说明
uperPpiint225上限 PPI(每英寸像素),高于此值的图像将被降采样
targetPpiint150目标 PPI,降采样后的目标分辨率
compressAlgorithmCPDFCompressAlgorithmJPEG2000压缩算法
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 压缩传真图像,单色位图

配置图像压缩选项

java
// 创建图像优化选项
CPDFImageOptimizeOptions imageOption = new CPDFImageOptimizeOptions();
imageOption.upperPpi = 300;     // 高于 300 PPI 的图像将被降采样
imageOption.targetPpi = 150;    // 降采样目标为 150 PPI
imageOption.compressAlgorithm = CPDFCompressAlgorithm.JPEG2000;      // 使用 JPEG 压缩
imageOption.quality = 60;                               // 图像质量 60%
imageOption.blockSize = 256;     // 块大小 256 字节

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

快速设置图像质量

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

java
// 设置图像质量 (1-100)
optimizeOption.setImageQuality(75.0f);

// 获取当前图像质量
float quality = optimizeOption.getImageQuality();