PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
ComPDFKit_Tools 的 CPDFCompressDialog 提供文档选择、预设质量、自定义参数、输出目录及压缩进度界面。
对话框会管理传入文档的生命周期,销毁时关闭该文档。使用独立文档实例,避免传入正在阅读或编辑的实例。以下代码在 Activity 中执行,pdfPath 为输入文件路径:
CPDFDocument compressionDocument = new CPDFDocument(this);
if (compressionDocument.open(pdfPath)
== CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
CPDFCompressDialog dialog = new CPDFCompressDialog();
dialog.setDocument(compressionDocument);
dialog.setCompressDocumentListener((success, path, uri) -> {
if (success) {
// 通过输出 path 或 uri 打开结果文件。
} else {
// 压缩、保存或取消后未得到成功结果。
}
});
dialog.show(getSupportFragmentManager(), "compress");
} else {
compressionDocument.close();
}val compressionDocument = CPDFDocument(this)
if (compressionDocument.open(pdfPath) ==
CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
val dialog = CPDFCompressDialog()
dialog.setDocument(compressionDocument)
dialog.setCompressDocumentListener { success, path, uri ->
if (success) {
// 通过输出 path 或 uri 打开结果文件。
} else {
// 处理未成功完成的情况。
}
}
dialog.show(supportFragmentManager, "compress")
} else {
compressionDocument.close()
}CPDFCompressDialog 位于 com.compdfkit.tools.compress 包,CPDFDocument 位于 com.compdfkit.core.document 包。
| 预设 | 降采样阈值/目标 PPI | 图片质量参数 |
|---|---|---|
| 低质量 | 120/96 | 30 |
| 标准质量 | 180/150 | 45 |
| 高质量 | 220/150 | 75 |
| 自定义 | 在自定义选项中设置 | 在自定义选项中设置 |
预设参数用于控制图片重编码与采样,输出大小取决于源文件。不要将预设名称当作固定的压缩率或画质保证。
选择“自定义”后,可打开 CPDFCustomCompressOptionsDialog 调整图片质量、PPI、嵌入字体及内容清理规则。降采样阈值应大于目标 PPI。
可清理的内容包括表单动作、JavaScript、页面缩略图、书签、注释与表单、附件、文档信息及图层等。移除字体或业务内容可能改变文档显示与功能,保存前应确认选项。
对话框在后台执行优化并显示进度;取消或关闭对话框会请求停止。结果通过 setCompressDocumentListener() 返回:
| 参数 | 说明 |
|---|---|
success | 优化及输出流程是否成功 |
path | 成功结果的可打开路径 |
uri | 公共目录输出对应的 Uri,按实际返回值使用 |
仅在 success 为 true 时使用输出路径或 Uri。压缩成功会关闭传入的文档实例,继续操作时重新打开输出文件。失败或取消时,不把未完成的输出作为有效结果。
需要直接配置算法、颜色空间转换或读取详细优化结果,参见 压缩与优化 PDF 文件。