Native Linux ABI form-appearances

hpdf_document_execute_json_v1 udfylder indlæste AcroForm-felter gennem forms.fill og genererer matchende normale appearances som standard og bevarer de originale PDF-revisioner, adgangskoder, security dictionary og dokument-ID'er

{"schemaVersion":1,"type":"forms.fill","fields":[
  {"name":"Notes","value":"First line Ω\nSecond café","fontSize":13},
  {"name":"Combo","value":"two"},
  {"name":"Colors","values":["blue","red"]},
  {"name":"Check","checked":true},
  {"name":"Radio","checked":true,"onState":"B"},
  {"name":"Submit","caption":"Send Ω"}
]}

Feltværdier og appearances

Tekstfelter accepterer value eller typede richTextRuns; en leveret værdi sammen med richTextRuns skal matche den udledte plain tekst eksakt, inklusive CR afsnitsseparatorer

Plain appearances respekterer nedarvede multiline-, comb-, justerings- og rotationsindstillinger og indlejrer den valgte Unicode TrueType-font; stylede runs bærer eksplicit font style, størrelse, farve, justering, afsnitsbrud og dekorationer

Password tekstfelter maskerer deres appearances og glyph-mappings med én bullet pr. Unicode-scalar, mens den faktisk gemte feltværdi og originale kryptering beholder; file-select-felter viser deres literal Unicode-sti uden at åbne den valgte fil

Choice-felter accepterer én value-streng eller et komplet values-array, aldrig begge; export-værdier mappes til option display-tekst, flere markeringer sorteres efter option-indeks, og et tomt array rydder markeringen

Checkboxer og radiogrupper kræver Boolean checked; onState er som standard Yes og vælger den matchende radio-widget, når den leveres eksplicit, mens rydning opdaterer både felt- og widget-tilstande

Push buttons kræver caption, som males med den valgte indlejrede Unicode-font

forms.read inkluderer det komplette values-array for hvert choice-felt, inklusive et tomt array efter rydning; scalar value-memberen forbliver tilgængelig

Til rich fields returnerer forms.read også den gemte XHTML richText-streng; almindelige værdierstatninger synkroniserer RV, og stylede runs kræver appearance-generering

Options og publicering

Enhver redigering accepterer fontFamily (standard DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) og paintWhiteBackground (true)

Typede rich-redigeringer kan også bruge fontFamilies-arrays og per-run familie-valg og beholder den originale enkelt-familie-adfærd, når arrayet er fraværende

Tekstredigeringer kan eksplicit sætte appearance:false til value-only-opdateringer; choice- og button-redigeringer kræver appearance-generering

Ukendte felter, duplikerede redigeringer, ugyldige markeringer, overdrevne comb-værdier, misdannede parametre, cancellation, ressourceopbrug og mislykkede callbacks efterlader det aktuelle indlæste dokument uændret; output forberedes, før nogen binær publicerings-callback kører

Operationsresultatet indeholder updated og den aktuelle feltliste; opdag understøttede appearance-typer gennem formAppearances-capability-arrayet

Native C ABI-accept genererer rigtige plaintext- og AES R5/R6-formularoutputs; uafhængige pypdf- og MuPDF-tjek inspicerer markeringindeks, widget-tilstande, indlejrede fonts, Unicode-værdier, kryptering og faktiske appearance-pixels

Native Linux C ABI · Signing workflows · Tilbageværende leveringsplan