Native Linux ABI form appearances

hpdf_document_execute_json_v1 vyplní načtená pole AcroForm přes forms.fill, defaultně generuje odpovídající normal appearance a zachovává původní PDF revize, hesla, bezpečnostní slovník i ID dokumentu

{"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 Ω"}
]}

Hodnoty polí a appearance

Textová pole přijímají value či typované richTextRuns; dodaná hodnota vedle richTextRuns se musí přesně shodovat s odvozeným prostým textem, tedy i s oddělovači odstavců CR

Prostá appearance respektují zděděné nastavení multiline, comb, zarovnání i rotace a vkládají vybrané Unicode TrueType písmo; stylované runy nesou explicitní styl, velikost, barvu a zarovnání písma, konce odstavců i dekorace

Password textová pole maskují svá appearance i glyfová mapování jednou odrážkou na Unicode skalár, při zachování skutečné uložené hodnoty pole i původního šifrování; file-select pole zobrazí svou literální Unicode cestu, aniž by otevřela vybraný soubor

Choice pole přijmou jeden řetězec value nebo kompletní pole values, nikdy obojí; exportní hodnoty se mapují na display text voleb, vícenásobné výběry se setřídí podle indexu volby a prázdné pole vymaže výběr

Checkboxy i radio skupiny vyžadují Booleovské checked; onState defaultuje na Yes a při explicitním dodání vybere odpovídající radio widget, zatímco vymazání aktualizuje stavy pole i widgetu

Push buttony vyžadují caption, která se maluje vybraným vloženým Unicode písmem

forms.read obsahuje kompletní pole values pro každé choice pole, tedy i prázdné pole po vymazání; skalární člen value zůstává dostupný

U rich polí vrací forms.read navíc uložený XHTML řetězec richText; běžné náhrady hodnot synchronizují RV a stylované runy vyžadují generování appearance

Volby a publikace

Každá editace přijímá fontFamily (default DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) a paintWhiteBackground (true)

Typované rich editace můžou navíc použít pole fontFamilies i výběr rodiny po runech, se zachováním původního chování jedné rodiny, když pole chybí

Textové editace můžou explicitně nastavit appearance:false pro aktualizace jen hodnoty; editace choice i button vyžadují generování appearance

Neznámá pole, duplicitní editace, neplatné výběry, nadměrné comb hodnoty, poškozené parametry, zrušení, vyčerpané resource i neúspěšné callbacky ponechají aktuální načtený dokument beze změny; výstup se připraví, dřív než běží jakýkoli binární publikační callback

Výsledek operace obsahuje updated a aktuální seznam polí; podporované typy appearance odhalte přes capability pole formAppearances

Nativní akceptace C ABI generuje skutečné výstupy formulářů plaintext i AES R5/R6; nezávislé kontroly pypdf a MuPDF prohlížejí selekční indexy, stavy widgetů, vložená písma, Unicode hodnoty, šifrování i skutečné pixely appearance

Nativní Linux C ABI · Signing workflows · Zbývající dodací plán