Native Linux ABI Formular-Appearances

hpdf_document_execute_json_v1 füllt geladene AcroForm-Felder über forms.fill, erzeugt standardmäßig passende Normal-Appearances und behält die Original-PDF-Revisionen, Passwörter, das Security-Dictionary und die Dokument-IDs bei

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

Feldwerte und Appearances

Textfelder akzeptieren value oder typisierte richTextRuns; ein neben richTextRuns gelieferter value muss exakt dem abgeleiteten Plain-Text entsprechen, einschließlich CR-Absatztrennern

Plain-Appearances respektieren geerbte multiline-, comb-, alignment- und rotation-Einstellungen und betten die ausgewählte Unicode-TrueType-Schrift ein; gestylte Runs tragen expliziten Schriftstil, Größe, Farbe, Ausrichtung, Absatzumbrüche und Dekorationen

Passwort-Textfelder verschleiern ihre Appearances und Glyphen-Zuordnungen mit einem Bullet pro Unicode-Scalar und behalten dabei den tatsächlich gespeicherten Feldwert und die Original-Verschlüsselung; Dateiauswahl-Felder zeigen ihren buchstäblichen Unicode-Pfad, ohne die gewählte Datei zu öffnen

Choice-Felder akzeptieren einen value-String oder ein vollständiges values-Array, nie beides; Exportwerte werden auf Option-Anzeigetext abgebildet, Mehrfachauswahlen werden nach Optionsindex sortiert, und ein leeres Array löscht die Auswahl

Checkboxes und Radio-Gruppen verlangen ein boolesches checked; onState ist standardmäßig Yes und wählt bei expliziter Angabe das passende Radio-Widget, während das Löschen sowohl Feld- als auch Widget-Zustände aktualisiert

Push-Buttons verlangen eine caption, die mit der ausgewählten eingebetteten Unicode-Schrift gemalt wird

forms.read enthält das vollständige values-Array für jedes Choice-Feld, auch ein leeres Array nach dem Löschen; das skalare value-Member bleibt verfügbar

Für Rich-Felder liefert forms.read zusätzlich den gespeicherten XHTML-richText-String; gewöhnliche Wertersetzungen synchronisieren RV, und gestylte Runs verlangen eine Appearance-Generierung

Optionen und Veröffentlichung

Jede Bearbeitung akzeptiert fontFamily (Default DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) und paintWhiteBackground (true)

Typisierte Rich-Bearbeitungen dürfen zusätzlich fontFamilies-Arrays und Familienauswahl pro Run verwenden und behalten das ursprüngliche Single-Family-Verhalten bei, wenn das Array fehlt

Text-Bearbeitungen dürfen explizit appearance:false für rein wertbezogene Updates setzen; Choice- und Button-Bearbeitungen verlangen eine Appearance-Generierung

Unbekannte Felder, doppelte Bearbeitungen, ungültige Auswahlen, übermäßige comb-Werte, missgebildete Parameter, Abbruch, Ressourcenerschöpfung und fehlgeschlagene Callbacks lassen das aktuell geladene Dokument unverändert; die Ausgabe wird aufbereitet, bevor irgendein binärer Veröffentlichungs-Callback läuft

Das Operationsergebnis enthält updated und die aktuelle Feldliste; unterstützte Appearance-Typen finden Sie über das formAppearances-Capability-Array

Die native C-ABI-Abnahme erzeugt echte Plaintext- und AES-R5/R6-Formularausgaben; unabhängige pypdf- und MuPDF-Prüfungen inspizieren Auswahlindizes, Widget-Zustände, eingebettete Schriften, Unicode-Werte, Verschlüsselung und echte Appearance-Pixel

Native Linux C ABI · Signing workflows · Remaining delivery plan