Windows Signature Appearance Profiles
De Windows sign-operatie kan een zichtbare Unicode-signature-appearance genereren vanuit een benoemde built-in preset en een expliciet meegeleverd embedbaar TrueType-font
{"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"}}
Echte preset-selectie
| profileName | Gegenereerde configuratie |
|---|---|
| HotPDF.StandardApproval | 11 pt gecentreerde blauwe tekst, 4 pt padding, een rechthoekige rand, een witte achtergrond en één tekstregel |
| HotPDF.StandardCertification | 10 pt links uitgelijnde zwarte tekst, 5 pt padding, een rechthoekige rand, een witte achtergrond, multiline wrapping en 1.35 regelspatiëring |
| HotPDF.Compact | 8 pt rechts uitgelijnde zwarte tekst, 1 pt padding, geen geschilderde achtergrond of rand en één tekstregel |
De gekozen preset configureert de echte producent in plaats van door de aanroeper gedefinieerde visuele options te labelen; dit zijn dezelfde configuraties die HPDFSelectHeadlessSignatureAppearanceProfile teruggeeft
text levert de echte caption en fontFile diens TrueType-programma; beide zijn vereist, niet-lege Unicode-strings, en alle drie de appearance-strings zijn begrensd op 16.384 UTF-8-bytes zonder NUL
Font-embedding-permissions, Unicode-geldigheid, beschikbare glyphs, complexe shaping-vereisten, caption-passing en geconfigureerde limieten worden tijdens generatie gehandhaafd
Widgets en getekende documenten
Generatie werkt de normale AP/N Form XObject bij voor elke Widget die bij het gekozen signature-veld hoort, inclusief samengevoegde velden en velden met aparte Widget-kinderen
Elke Widget levert diens eigen positieve rechthoek-dimensies en optionele MK/R-rotatie van 0, 90, 180 of 270 graden aan; preset-uitlijning heeft voorrang op geërfde uitlijningshints
Rollover- en down-appearances worden behouden wanneer een bestaand AP-dictionary aanwezig is; misvormde geometrie, appearance-dictionaries, rotaties of cyclische Widget-hiërarchieën verwerpen generatie
De signing-operatie ondersteunt bestaande velden, nieuwe velden, incrementele versleutelde updates, unsigned-document-signing, eerste certification-signatures en daaropvolgende approval-signatures toegestaan door P2 of P3 en field-lock-policies
Gebruik certificationPermission om echt certification-gedrag te kiezen; alleen de StandardCertification-appearance kiezen certificeert het document niet
Gegenereerde font- en appearance-objecten volgen het originele document-encryptiebeleid, terwijl de originele bronprefix en eerdere signatures intact blijven voor toegestane incrementele signing
Seed-vereisten en limieten
Een vereiste SV AppearanceFilter matcht alleen de preset die werkelijk in deze signing-operatie is gegenereerd; bestaande metadata of een eerder opgeslagen appearance volstaat op zichzelf niet
Het AP-dictionary registreert HotPDFProfile voor inspectie, terwijl het geslaagde resultaat appearanceProfile rapporteert; beide beschrijven de preset die deze operatie gebruikte
Fontbytes zijn afgeklemd op het kleinste van 8 MiB en een achtste van memoryBytes, gegenereerde appearance-bytes delen een cap van een achtste van memoryBytes, en elke Widget voegt zeven begrensde objecten toe onderworpen aan objectCount
Annulering, ongeldige presets, onvervulde vereiste seeds en ongeldige generatie behouden de originele document-handle en publiceren geen PDF-bytes; uitvoer-callbacks behouden de bestaande callback-faal-semantics
Combineer appearance met echte signing-timestamps, certification en legal attestation, of geauthenticeerde signed revocation-informatie
Zie Incrementele PFX Signing voor de operation-levenscyclus, permissions, budgetten en publicatiecontract