Windows 署名アピアランスプロファイル

Windows の sign 操作は、名前付き組み込みプリセットと明示的に指定された埋め込み可能 TrueType フォントから、可視の Unicode 署名アピアランスを生成できます

{"schemaVersion":1,"type":"sign","incremental":true,
 "existingField":true,"fieldName":"ApprovalOne",
 "pfxFile":"C:/keys/signer.pfx","pfxPassword":"password",
 "appearance":{"profileName":"HotPDF.StandardApproval",
   "text":"Signed by Alice","fontFile":"C:/fonts/DejaVuSans.ttf"}}

実際のプリセット選択

選択されたプリセットは、呼び出し側定義の見た目オプションにラベルを貼るのではなく、実際のプロデューサーを設定します。これらは HPDFSelectHeadlessSignatureAppearanceProfile が返すのと同じ構成です

text が実際のキャプションを、fontFile がその TrueType プログラムを供給します。両方とも必須の空でない Unicode 文字列で、3 つのアピアランス文字列はすべて NUL なしの 16,384 UTF-8 バイトまでに制限されます

フォント埋め込み権限、Unicode の妥当性、利用可能グリフ、複雑なシェーピングの要件、キャプションの収まり、設定された上限は、生成中に強制されます

ウィジェットと署名済みドキュメント

生成は、選択された署名フィールドに属するすべての Widget の normal AP/N Form XObject を更新します。マージされたフィールドや別 Widget の子を持つフィールドも含みます

各 Widget は自身の正の矩形寸法と、0、90、180、270 度の省略可能な MK/R 回転を供給します。プリセットの配置が継承された配置ヒントより優先されます

既存の AP 辞書がある場合、rollover と down のアピアランスは保持されます。不正なジオメトリ、アピアランス辞書、回転、循環 Widget 階層は生成を棄却します

sign 操作は、既存フィールド、新規フィールド、増分暗号化更新、未署名ドキュメントの署名、最初の証明署名、そして P2 か P3 とフィールドロックポリシーが許可する続く承認署名に対応します

実際の証明動作の選択には certificationPermission を使ってください。StandardCertification アピアランスを選ぶだけではドキュメントは証明されません

生成されたフォントとアピアランスオブジェクトは元のドキュメント暗号化ポリシーに従い、許可された増分署名では元ソース接頭辞と先行署名がそのまま保たれます

シード要件と上限

必須の SV AppearanceFilter は、この sign 操作で実際に生成されたプリセットにだけ一致します。既存メタデータや以前保存したアピアランスだけでは要件を満たしません

AP 辞書は検査用に HotPDFProfile を記録し、成功した結果は appearanceProfile を報告します。どちらもこの操作が使ったプリセットを記述します

フォントバイトは 8 MiB と memoryBytes の 8 分の 1 の小さい方に制限され、生成アピアランスバイトは memoryBytes の 8 分の 1 の上限を共有し、各 Widget は objectCount の対象となる上限付きオブジェクトを 7 個追加します

キャンセル、無効なプリセット、未充足の必須シード、無効な生成は元のドキュメントハンドルを保ち PDF バイトを公開しません。出力コールバックは既存のコールバック失敗セマンティクスを保ちます

appearance は実際の署名タイムスタンプ、証明と法的証明、認証済み署名付き失効情報と組み合わせられます

操作ライフサイクル、権限、予算、公開契約は増分 PFX 署名を参照してください