PDFlib+PDI导入未扁平化带批注PDF的问题

• 检查PDI页面导入参数，开启批注导入
  默认情况下PDFlib的open_pdi_page可能不会自动导入页面批注，你可以在调用该函数时添加annotations=all选项，强制导入所有页面级批注。示例代码片段：

  int page = p.open_pdi_page(pdi, page_num, "annotations=all");
  

  这个参数会让PDI导入页面上的所有批注类型，包括文本框、高亮、注释框等常见批注。

• 手动复制批注（自动导入失效时）
  如果自动导入仍有问题，可以通过PDFlib的批注遍历与复制接口手动处理：

  1. 用pcos_get_number获取原页面的批注数量：int annot_count = (int) p.pcos_get_number(pdi, "pages[" + (page_num-1) + "]/Annots");
  2. 循环遍历每个批注，用copy_annotation函数将其复制到新生成的页面上：

     for (int i = 0; i < annot_count; i++) {
         String annot_ref = "pages[" + (page_num-1) + "]/Annots[" + i + "]";
         p.copy_annotation(pdi, annot_ref, new_page, "");
     }
     

  这种方式可以精准控制每个批注的复制，适配一些特殊类型的批注。

• 验证PDFlib版本与批注兼容性
  部分旧版PDFlib对现代PDF批注（比如PDF 2.0标准的批注）支持有限，建议升级到最新稳定版（如PDFlib 10及以上），新版本对批注的导入与处理逻辑更完善，能覆盖更多批注类型。

• 检查批注的存储位置
  有些批注可能属于文档级而非页面级（比如文档附件、全局注释），这类内容需要通过open_pdi_document的相关参数或额外的PCOS接口来复制，确保文档级的批注也被迁移到合并后的文件中。

内容的提问来源于stack exchange，提问作者Mindflux