註解 XFDF 目標
原生註解 XFDF、Windows 檔案工作與 V1 callback、以及原生 Linux V1 callback,都在 Link 註解中保留具名目標與本機明確頁目標,遠端 GoToR 走單獨的遠端 GoToR 路徑
直接的 Dest 對應到註解的 PDF 目標物件,而 OnActivation/Action/GoTo/Dest 對應到本機 GoTo action;頁索引從零開始,並在匯入時綁到真實的間接頁物件
| 目標 | 屬性 |
|---|---|
| 具名 | Name,保留 Unicode 與字面 PDF 名稱跳脫字元 |
| Fit、FitB | Page |
| FitH、FitBH | Page、Top |
| FitV、FitBV | Page、Left |
| FitR | Page、Left、Bottom、Right、Top |
| XYZ | Page 與選用的 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,包含接近座標上限的長小數部分
交易與 callback
原生檔案交易在發佈前驗證目標,失敗時保留已載入圖與先前目標,並沿用既有的註解、物件、深度、位元組與工作儲存預算
Windows 與 Linux JSON 入口透過各自既有的 V1 操作記錄使用相同的映射編解碼器;callback 失敗或取消保留先前已提交的 PDF,而呼叫端自有的 callback sink 可能已收到候選位元組
寫 callback 失敗不會經由別名輸出或結果 sink 重試;同一規則適用於雙控制代碼比較,未定義的寫入狀態值轉為標準 IO 錯誤狀態
共用的 HPDFXFDF 編解碼器在新 overload 中接受獨立的目標 callback 記錄;legacy 存取記錄配置保持不變
THotPDF 已載入註解方法自動綁定這些 callback;直接呼叫編解碼器時必須為目標提供 page count 與頁解析 callback
邊界
本 profile 只映射本機 GoTo 與目標資料,不執行 action;Launch、任意 action 字典、目標名稱樹撰寫、AP 傳輸與註解替換/移除仍是獨立能力