图片与图形编辑：替换、裁剪、旋转与次序

PDF 页面上的内容不是「一页」，而是一堆对象：文字对象、图像对象、路径（图形）对象。SDK 把这些对象暴露出来，你就能按对象替换、删除与变换。

图片对象能做什么

• 添加与删除。
• 旋转、裁剪、等比缩放。
• 次序管理——谁盖住谁。

次序这条最容易被忽略：页面上同时有图和文字时，「图压字」还是「字压图」直接决定可读性。在 PDF 里它不是样式问题，而是绘制顺序问题。

图形（路径）对象能做什么

• 删除。
• 拉伸缩放与旋转。
• 颜色修改。

路径对象是矢量图形（线条、形状、图表元素）。改颜色这类操作不会掉分辨率——比截图替换干净得多。

对应的接口分组

• 页面对象（ipdf_pageobject）：文字、图像、路径等页面元素的查询与修改，5 个类、42 个方法，见页面对象的接口文档。
• 页面（ipdf_page）：页面元素访问与页面属性。

一个实际用法

产品手册换 Logo、房源册换封面、报表换图——都是同一套动作：找到那个图像对象 → 替换 → 调大小与次序。比起重新生成整份 PDF，按对象替换是最省事的一条路。

常见问题

替换后画质会变差吗？

取决于你换上去的那张图本身的分辨率。替换动作不会额外压缩它。

能按坐标选中对象吗？

页面对象层提供元素访问，具体方式见接口文档。

能新增图形吗？

公开文档里图形这组侧重已有路径的删除、变换与颜色修改。有新增图形的需求请与我们确认。

能把图片提取出来吗？

页面对象层可以访问图像元素，提取的具体接口同样见文档。

来源：知叶PDF 官方文档。能力范围以 SDK 接口文档为准，更新于 2026 年 9 月。