標準 XFDF スタンプ外観トランスポート

Stamp 注釈は、Adobe XFDF の appearance 要素を通じて、実際の PDF 外観ストリームとリソースディクショナリをエクスポート・インポートできます

stamp-typed-xml-v1 プロファイルは、Adobe XFDF 3 仕様が記述する、base64 エンコードされた UTF-8 の型付き XML を使います。デコードされたペイロードは、完全な PDF や FDF ファイルではなく PDF オブジェクトを表します

マップ済みリソース

トップレベルの DICT KEY="AP" は、必須の normal N Form ストリームと、オプションの rollover R、down D ストリームを含みます

Form は、有限の 4 数値 BBox、オプションの 6 数値 Matrix、フォントとその埋め込みプログラム、画像とソフトマスク、カラースペース、パターン、シェーディング、関数、グラフィックスステートを含むサポートされるリソースグラフを保持します

型付き値は DICT、STREAM、ARRAY、INT、FIXED、NAME、BOOL、NULL を含みます。ディクショナリキーと名前値は意味的な PDF 名を保持し、有効なソース数値トークンは 10 進精度を保持します

ストリームの DATA は MODE="RAW" か MODE="FILTERED" で、ENCODING="HEX" か 7 ビットの ENCODING="ASCII" をサポートします。RAW はエンコードバイトと Filter/DecodeParms を保持し、FILTERED は陳腐化したフィルタメタデータなしでデコード済みバイトを設置します

エクスポートは 16 進 RAW データを使い、実際のバイトからストリームの Length を再生成します。認証済み暗号化ストリームは交換前にデコード・復号され、保存リビジョンでは正しく暗号化されます

共有の非巡回リソースは等価な値として展開され、独立したオブジェクト参照でインポートされます。このプロファイルは参照の同一性を保持しません

埋め込みフォントプログラムのバイトとその埋め込みフラグは、ライセンスビットを変えず、別のフォントプログラムに置き換えずに保持されます

API とコールバック

ネイティブトランザクションには HPDFExportHeadlessAnnotationsXFDF と SaveAnnotationsXFDFToFile を、呼び出し側所有のグラフアダプタには HPDFXFDFExportAnnotations と HPDFXFDFImportAnnotations の上限付きオーバーロードを使ってください

既存の Windows ファイルジョブと V1 コールバック、Linux V1 コールバックは、既存の注釈操作とレコードレイアウトを使います

機能は、一般的な注釈外観に対する appearanceImport=false を保持し、stampAppearanceImport=true、appearanceProfile="stamp-typed-xml-v1"、appearanceTypes=["stamp"]、appearanceDataModes=["RAW","FILTERED"]、appearanceEncodings=["ASCII","HEX"]、appearanceResources="acyclic-expanded-graph" を追加します

トランザクションと上限

入力 XML、base64、名前、ストリームエンコーディング、リソースタイプ、意味的なディクショナリキー、Form ジオメトリは公開前に検証されます。不正データ、サイクル、累積上限の枯渇、キャンセルはトランザクション全体を失敗させます

XFDF 上限は、注釈操作全体で、入出力合計、XML・グラフノード、深さ、ストリーム格納、作業予約をカバーします

インポートは、保存されていない現在のグラフ状態、AES R5/R6 セキュリティ、認証済み証明制限を保持します。P1/P2 は注釈変更を拒否し、P3 は元の署名済み接頭辞と本物の署名整合性を保持します

許可された空インポートはゼロを返し、保存されていない変更がなければ正確な現在の PDF バイトを保持します。ダーティなグラフ変更は破棄されずに保存されます

Windows と Linux のコールバックコンテキストは、PDF 出力、JSON 結果出力、最終キャンセル検査がすべて成功した後にのみ準備済み PDF を採用します。失敗または部分的なコールバックは以前のコンテキストを保持し、最初に失敗したライタは粘着的です

注釈のみのインポートは、空の fields コンテナと値のないフィールド宣言を no-op メタデータとして受け付けます。実際のフォーム値とリッチフィールド更新には、別の認証済みフォームデータ操作が必要です

残作業

一般的な注釈 AP 転送、外観状態ディクショナリ、文字列リソース値、非空の DEFINE/REF 参照、巡回グラフ、Redact の overlayappearance、注釈の置換・削除、FDF 注釈交換は別の作業です

転送されたスタンプ外観のない幾何・テキスト注釈は既存の動作を保持します。この操作は任意の注釈外観を合成せず、アクションも実行しません

共有の上限付きアダプタは、ペイロード変換の前に生の注釈キーと展開済み AP グラフを予約し、それらの表現を割り当てる前に base64 空白とデコード済み DATA を予約します。PDF 名の変換は、キャンセルチェックポイント付きの線形パスを使います