SaveAsPdfR 方法

SaveAsPdfR 先执行常规的 SaveAs，然后在保存的 字节之上叠加一个增量更新，附加 PDF/R-1 文件格式标记。PDF/R-1（ISO 23504-1:2020）是 TWAIN 工作组 用于扫描文档工作流的严格 光栅图像传输子集；它每个页面携带一个固定大小 的光栅缓冲区，仅支持黑白 / 灰度 / RGB 图像 和 FlateDecode / CCITTFaxDecode / DCTDecode 压缩

后处理将五类字节注入保存的 流中：

• %PDF-raster-1.0 版本标识注释，写在尾部字典和 startxref 关键字之间（ISO 23504-1 §5）。这是 PDF/R 独有的 — 其他 PDF/x 标准通过 XMP 和 Info 字典条目来标识自己
• 剥离到 §6.3 白名单的文档目录。仅保留可选条目 Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata；所有其他目录条目（Names / Outlines / Dests / StructTreeRoot / OutputIntents / Lang / PageLabels / OCProperties / 等）被移除
• 剥离到 §6.4.3 白名单的文档信息字典。仅保留 Creator / Producer / CreationDate / ModDate；Title / Author / Subject / Keywords / Trapped 被移除
• 携带四个 §6.4.4 表 1 属性（xmp:CreatorTool、pdf:Producer、xmp:CreateDate、xmp:ModifyDate）加 xmp:MetadataDate 的目录 /Metadata XMP 流
• 尾部 /ID 数组（§5 示例推荐）

输出在原始 PDF 结束之前与基础 SaveAs 结果字节完全一致； 只有增量更新被 追加（源目录 / Info 通过同对象编号重写替换为剥离 版本）。两个重载 仅在传入配置的方式上不同：仅文件名 形式使用 TPdfRSaveOptions.Default， 从 FPDF_GetMetaText / FPDF_GetFileIdentifier 自动填充四个 Info 字段和 DocumentId

成功时返回 True

• SaveAsPdfR 附加 PDF/R 要求的文件格式级标记 — 它不保证源 PDF 的内容已经满足 PDF/R 的结构限制。PDF/R 比其他 PDF/x 标准严格得多：每个页面必须恰好有一个 /Contents 条目，MediaBox 必须是 [0 0 w h]，仅允许 FlateDecode / CCITTFaxDecode（黑白）/ DCTDecode（8 位灰度或 RGB）过滤器，无对象流，每个间接引用必须具有零代编号，每个页面本质上是一张光栅图像。已经匹配此模式的 PDFium 生成文档（例如通过 PDFium 重新打包的扫描仪输出）工作良好；任意内容丰富 PDF 通常不行
• 在 SaveAsPdfR 之后使用 ValidatePdfR 确认源实际达到的结果。配合 TWAIN 工作组 PDF/R 验证器进行完整内容级验证
• TPdfRSaveOptions.StripCatalogOptionalEntries 和 StripInfoOptionalEntries 默认为 True；如果希望注入器保留所有源条目，则设为 False（输出将不满足 §6.3 / §6.4.3，但仍附加版本标记和 XMP）
• PDF/R §6.2.3 允许加密，但仅限 %PDF-2.0 头和 AES 加密。PDFium 生成的 PDF 使用 1.x 头，因此没有进一步重新保存时，加密输出不是 PDF/R-1 候选