原生註解 XFDF 交換

HPDFHeadlessXFDF 從已載入的原生 PDF 圖匯出映射註解，並把 XFDF 註解匯入準備為獨立的增量修訂版

UTF-8 XML 位元組用 HPDFExportHeadlessAnnotationsXFDF，向既有文件附加註解且不更動已載入來源圖用 SaveAnnotationsXFDFToFile

映射註解 profile

該 profile 映射 Text、FreeText、Line、Square、Circle、Polygon、PolyLine、Highlight、Underline、StrikeOut、Squiggly、Stamp、Ink、Caret、FileAttachment、Sound、Redact 與 Link

共用值包含頁、矩形、Unicode 內容、作者、註解名稱、日期、主題、旗標、不透明度、顏色與受支援的邊框屬性

型別專屬值包含四邊形座標、頂點、ink 手勢、線端與引導線幾何、FreeText 的 intent/callout/fringe／預設文字屬性、Redact 重複狀態、URI 或具名連結 action、遠端 GoToR action，以及具名或明確本機目標與 GoTo action

空顏色分量陣列保留透明色；Gray 與 CMYK 來源顏色映射為 XFDF RGB 值，RGB 分量量化為該格式的六位十六進位表示

FileAttachment 匯出優先使用 Unicode 檔案名稱，即使不存在內嵌串流也保留外部檔案詮釋資料；內嵌檔案與聲音資料解碼為設有上限的規範 base64，並作為真實間接串流匯入，空串流也不例外

Popup 註解表示為巢狀的 popup 元素，匯入時帶間接 Parent、Popup 與頁連結；回覆在第二輪中對照既有與新附加的註解名稱解析，前向參照也不例外

rich 內容保留 XHTML 命名空間、有序混合文字與繼承的命名空間綁定

交易與權限

匯入以附加方式加入註解，在發佈前拒絕重複名稱、含糊或缺失的回覆目標以及非法映射值

失敗或被取消的匯入保留目標檔案與已載入來源圖；成功的匯入同樣讓已載入來源保持不變，想採用新修訂版時請載入儲存後的檔案

匯出需要萃取權限，匯入需要註解權限；AES-256 R5/R6 安全性保留在儲存的修訂版中

真實的認證政策經原生簽章工作流程驗證：P1 與 P2 阻止註解變更，P3 允許保留原始已簽署位元組的註解修訂版

邊界

THPDFHeadlessXFDFOptions 對輸入／輸出位元組、註解數量、圖與 XML 節點、深度與工作儲存設限，並支援合作式取消

映射數值必須是有限值且絕對值不超過一百萬，座標數量、不透明度、取樣尺寸與其他型別化值另有約束

整份文件的 XML 準入在註解映射之前檢查編碼、命名空間、重複屬性、實體與完整結構；DTD 與外部實體處理被停用

操作邊界

標準 stamp 外觀傳輸透過 base64 型別化 XML 保留真實的 Form 串流以及設有上限的無環字型、影像與圖形資源

通用註解 AP 傳輸、自訂註解字典、註解替換／移除、任意 action 與 FDF 註解資料仍是獨立工作

註解外觀合成與渲染是獨立操作；匯入幾何與文字屬性不會建立 AP 串流

其他來源註解子型別在匯出時被略過並計入結果；選中的映射值畸形時操作失敗，不回傳部分 XML

原生 Pascal API 在 Windows 與 Linux 上可用；版本化 Linux C ABI 也暴露以 callback 為基礎的 JSON 註解操作，Windows 檔案工作與 V1 callback 暴露相同的映射註解交換

明確的註解移除

按頁面與名稱的註解移除是單獨的操作；在匯入的 FDF 或 XFDF 中省略某個註解不會刪除它

Widget 欄位樹刪除與安全抹除需要單獨的操作；增量移除保留先前的 PDF 位元組