ネイティブ注釈 XFDF 交換

HPDFHeadlessXFDF は、ロード済みネイティブ PDF グラフからマップ済み注釈をエクスポートし、XFDF 注釈インポートを独立したインクリメンタルリビジョンとして準備します

UTF-8 XML バイトには HPDFExportHeadlessAnnotationsXFDF を、ロード済みソースグラフを変えずに既存ドキュメントへ注釈を追加するには SaveAnnotationsXFDFToFile を使ってください

マップ済み注釈プロファイル

このプロファイルは、Text、FreeText、Line、Square、Circle、Polygon、PolyLine、Highlight、Underline、StrikeOut、Squiggly、Stamp、Ink、Caret、FileAttachment、Sound、Redact、Link をマップします

共通値には、ページ、矩形、Unicode コンテンツ、作成者、注釈名、日付、subject、フラグ、不透明度、色、サポートされる境界プロパティがあります

タイプ固有の値には、四辺形座標、頂点、インクジェスチャ、線端・リーダージオメトリ、FreeText の intent/callout/fringe/既定テキストプロパティ、Redact の repeat 状態、URI・Named リンクアクション、リモート GoToR アクション、名前付き・明示的なローカル宛先と GoTo アクションがあります

空の色成分配列は透明色を保持します。Gray と CMYK のソース色は XFDF RGB 値にマップされ、RGB 成分は形式の 6 桁 16 進表現に量子化されます

FileAttachment のエクスポートは Unicode ファイル名を優先し、埋め込みストリームがなくても外部ファイルメタデータを保持します。埋め込みファイルと音声データは上限付きの正準 base64 にデコードされ、空ストリームを含め実際の間接ストリームとしてインポートされます

Popup 注釈はネストした popup 要素として表現され、間接の Parent・Popup・ページリンク付きでインポートされます。応答は、前方参照を含め、既存・新規追加の注釈名に対する第 2 パスで解決されます

リッチコンテンツは、XHTML 名前空間、順序付き混在テキスト、継承された名前空間バインディングを保持します

トランザクションと権限

インポートは注釈を追加し、公開の前に、重複名、曖昧・欠落の応答ターゲット、無効なマップ済み値を拒否します

失敗またはキャンセルされたインポートは、宛先ファイルとロード済みソースグラフを保持します。成功したインポートもロード済みソースを変更しないため、新しいリビジョンを採用したいときは保存されたファイルをロードしてください

エクスポートには抽出権限が、インポートには注釈権限が必要です。AES-256 R5/R6 セキュリティは保存リビジョンに残ります

実際の証明ポリシーは、ネイティブ署名ワークフローを通じて認証されます。P1 と P2 は注釈変更を防ぎ、P3 は元の署名済みバイトを保持する注釈リビジョンを許可します

境界

THPDFHeadlessXFDFOptions は、協調キャンセル付きで、入出力バイト、注釈数、グラフ・XML ノード、深さ、作業ストレージを制限します

マップ済み数値は有限で、絶対値 100 万以内でなければなりません。座標数、不透明度、サンプルサイズ、その他の型付き値には追加制約があります

ドキュメント全体の XML 許可は、注釈マッピングの前に、エンコーディング、名前空間、重複属性、実体、完全な構造を検査します。DTD と外部実体の処理は無効化されています

操作境界

標準スタンプ外観トランスポートは、base64 型付き XML を通じて実際の Form ストリームと、上限付きの非巡回フォント・画像・グラフィックスリソースを保持します

一般的な注釈 AP 転送、カスタム注釈ディクショナリ、注釈の置換・削除、任意のアクション、FDF 注釈データは別の作業です

注釈外観の合成とレンダリングは別の操作です。幾何・テキストプロパティのインポートは AP ストリームを作りません

他のソース注釈サブタイプはエクスポート中にスキップされ、結果にカウントされます。選択されたマップ済み値の不正は、部分的な XML を返さずに操作を失敗させます

ネイティブ Pascal API は Windows と Linux で動作します。バージョン付き Linux C ABI もコールバックベースの JSON 注釈操作を公開し、Windows のファイルジョブと V1 コールバックも同じマップ済み注釈交換を公開します

明示的な注釈削除

ページと名前による注釈削除は別個の操作です。インポートした FDF や XFDF から注釈を省いても、削除は行われません

ウィジェットのフィールドツリー削除とセキュア消去は別個の操作が必要です。インクリメンタル削除は以前の PDF バイトを保持します