Windows 簽章外觀設定檔

Windows 簽章操作可以從具名內建預設集與明確提供的可內嵌 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 字串,三個外觀字串都以 16,384 個 UTF-8 位元組為限且不含 NUL

字型內嵌權限、Unicode 有效性、可用 glyph、複雜 shaping 需求、標題貼合與已設定的限制,都在產生期間強制執行

Widget 與已簽署文件

產生會為所選簽章欄位的每個 Widget 更新 normal AP/N Form XObject,包括合併欄位與帶獨立 Widget 子節點的欄位

每個 Widget 提供自己的正矩形尺寸與選填的 MK/R 旋轉(0、90、180 或 270 度);預設集對齊優先於繼承的對齊提示

存在 AP 字典時,rollover 與 down 外觀會被保留;格式錯誤的幾何、外觀字典、旋轉或循環的 Widget 階層會拒絕產生

簽章操作支援既有欄位、新欄位、增量加密更新、未簽署文件簽章、第一個認證簽章,以及 P2 或 P3 與欄位鎖原則允許的後續核准簽章

請用 certificationPermission 選擇實際的認證行為;只選 StandardCertification 外觀並不會讓文件變成認證

產生的字型與外觀物件遵循原始文件的加密原則,而原始來源前綴與較早的簽章在允許的增量簽章下保持完整

Seed 需求與限制

必填的 SV AppearanceFilter 只比對這次簽章操作實際產生的預設集;既有 metadata 或先前儲存的外觀本身不能滿足該需求

AP 字典記錄 HotPDFProfile 供檢視,成功的結果回報 appearanceProfile;兩者描述的都是這次操作使用的預設集

字型位元組上限為 8 MiB 與 memoryBytes 八分之一中的較小值,產生的外觀位元組共用 memoryBytes 八分之一的配額,每個 Widget 會加入七個受限物件並計入 objectCount

取消、無效預設集、未滿足的必填 seed 與無效產生都會保留原始文件 handle,且不發布任何 PDF 位元組;輸出 callback 沿用既有的 callback 失敗語意

可將外觀與實際的簽章時間戳記、認證與法律聲明,或已驗證的簽署撤銷資訊搭配使用

操作生命週期、權限、預算與發布合約詳見增量 PFX 簽章