注释 XFDF 目标

原生注释 XFDF、Windows 文件作业与 V1 回调、以及原生 Linux V1 回调,都在 Link 注释中保留具名目标和本地显式页目标,远程 GoToR 走单独的远程 GoToR 路径

直接的 Dest 映射到注释的 PDF 目标对象,而 OnActivation/Action/GoTo/Dest 映射到本地 GoTo action;页索引从零开始,并在导入时绑定到真实的间接页对象

目标属性
具名Name,保留 Unicode 和字面 PDF 名称转义字符
Fit、FitBPage
FitH、FitBHPage、Top
FitV、FitBVPage、Left
FitRPage、Left、Bottom、Right、Top
XYZPage 和可选的 Left、Top、Zoom

属性模型遵循 Adobe 的 XML Forms Data Format Specification, Version 3.0 印刷页 59-68 和 88;PDF 目标语义由 ISO 32000 定义

规范的 XYZ 导出省略 PDF 对象为 null 的坐标;缺失的可选坐标保留阅读器当前坐标或缩放,zoom 为零保留标准 PDF 语义

兼容 profile 也接受字面 null 和空坐标属性作为 null 值;FitH/FitV/FitBH/FitBV 的必需属性在其 PDF 对象为 null 时输出字面 null,不宣称通过 ISO schema 认证

FitR 要求全部四个数值边界;其他 Fit 模式的必需属性不可省略,Page 必须是标识真实存在页面的十进制整数

精度与边界

限定的 Adobe 元素名与继承的命名空间绑定保留同样的目标;外来目标命名空间和重复 XML 属性在注释创建之前被拒绝

坐标必须是有限值、精确绝对十进制值不超过 1000000,zoom 不得为负;数值输入和展开的十进制输出以 8192 字符为限

带符号小数和科学计数法在该限制内被接受,然后写成不带指数记法的 PDF 十进制 token;即使 legacy 公开 Single 值舍入或下溢,源 token 仍保留编写时的精度

保存后的 PDF 重新加载和后续 XFDF 导出都保留该十进制 token,包括接近坐标上限的长小数部分

事务与回调

原生文件事务在发布前校验目标,失败时保留已加载图和先前目标,并沿用既有的注释、对象、深度、字节和工作存储预算

Windows 和 Linux JSON 入口通过各自既有的 V1 操作记录使用相同的映射编解码器;回调失败或取消保留先前已提交的 PDF,而调用方自有的回调 sink 可能已收到候选字节

写回调失败不会经由别名输出或结果 sink 重试;同一规则适用于双句柄比较,未定义的写状态值转换为标准 IO 错误状态

共享的 HPDFXFDF 编解码器在新 overload 中接受独立的目标回调记录;legacy 访问记录布局保持不变

THotPDF 已加载注释方法自动绑定这些回调;直接调用编解码器时必须为目标提供 page count 和页解析回调

边界

本 profile 只映射本地 GoTo 与目标数据,不执行 action;Launch、任意 action 字典、目标名称树编写、AP 传输和注释替换/移除仍是独立能力

映射注释 profile · Windows 操作 · Linux 回调