ネイティブ注釈 FDF 交換

バイナリ FDF 注釈交換は、各注釈を固定 XML ボキャブラリにマッピングするのではなく、PDF オブジェクトグラフを保持します

FDF バイトの生成には ExportAnnotationsFDF を、独立したインクリメンタル PDF リビジョンの準備には SaveAnnotationsFDFToFile を使用します

グラフと外観リソース

グラフは、名前、正確な数値トークン、リテラルおよび 16 進文字列バイト、配列、ディクショナリ、間接参照、ストリームバイトを保持します

注釈の外観状態、AS 選択、共有フォントと画像、Redact RO ストリームは共有参照トポロジを保持します。出力オブジェクト番号とシリアライズは変化し得ます

ストリーム長はエンコード時に保持バイトから再生成されます。間接ソース長はデコード中に解決され、公開前に検査されます

A 内の明示的なローカル GoTo 宛先配列、許可された AA イベント、Next チェーンは、実際のアクションコンテキストで宛先ドキュメントのページオブジェクトに再マッピングされます。リソースグラフ内の他の場所にあるディクショナリは、キーがアクションに似ていてもアクション扱いされません

この交換は、スクリプトの実行、外部ファイル参照の追跡、宛先へのナビゲート、redaction の適用をせずにアクションデータを保持します

インポート動作

FDF の Page 値は 0 起点のページインデックスであり、ロード済みドキュメントのページを識別しなければなりません

同一ページ上の一致する空でない NM は、置換対象の既存注釈を識別します。名前なしまたは不一致の注釈は追加され、曖昧な名前は公開前に失敗します

意味的に変化しない注釈インポートは 0 を返します。正確な no-op 公開とコールバック回復は受け入れ契約の一部です

ネイティブの保存メソッドは、成功時も失敗時もロード済みドキュメントを変更しません。保存された PDF をロードして新しいリビジョンを採用してください

権限と上限

エクスポートには抽出権限が必要で、実際の注釈変更には注釈権限と認証済み署名ポリシーの許可が必要です

認証 P1 と P2 は注釈変更を阻止します。許可された P3 リビジョンは元の署名バイトを保持し、暗号化入力の権限とフィールドロックポリシーは実際のドキュメントに対して評価されます

THPDFFDFOptions はバイト、ノード、オブジェクト、深さ、注釈数、作業ストレージを個別に制限し、パース、準備、出力全体で協調的キャンセルを提供します

失敗またはキャンセルされた保存は、宛先ファイルとロード済みグラフを保持します。出力や結果公開が失敗しても、コールバッククライアントは最後にコミットされたドキュメントを保持します

境界

Link、Movie、Widget、PrinterMark、Screen、TrapNet は標準 FDF Annots プロファイルから除外されます

注釈のみのインポートは、空でない Fields と埋め込みドキュメント Differences を、その影響を黙って破棄するのではなく拒否します

任意の XFDF 外観コンテナ構文、注釈削除、埋め込み FDF ファイル処理、埋め込みドキュメントリビジョンの適用は、別個の作業です

外観トランスポートは提供された AP リソースを保持します。欠落した外観の合成や注釈アクションの実行は行いません

XML プロファイルについては マップ済み XFDF 交換を、スタンドアロンのグラフ API については THPDFFDFAnnotationGraph を参照してください

明示的な注釈削除

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

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