Appearance dei moduli ABI nativa di Linux

hpdf_document_execute_json_v1 compila i campi AcroForm caricati tramite forms.fill, generando per default le normal appearance corrispondenti e conservando revisioni originali del PDF, password, dizionario di sicurezza e document ID

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

Valori dei campi e appearance

I campi testo accettano value o richTextRuns tipizzati; un value fornito accanto a richTextRuns deve corrispondere esattamente al testo semplice derivato, inclusi i separatori di paragrafo CR

Le appearance semplici rispettano le impostazioni ereditate di multiline, comb, allineamento e rotazione e incorporano il font TrueType Unicode selezionato; i run stilizzati portano stile, size, colore, allineamento, interruzioni di paragrafo e decorazioni espliciti

I campi testo password mascherano appearance e mappature glyph con un bullet per ogni Unicode scalar conservando il vero valore memorizzato del campo e la cifratura originale; i campi file-select mostrano il loro percorso Unicode letterale senza aprire il file selezionato

I campi choice accettano una stringa value o un array values completo, mai entrambi; i valori export mappano al testo visualizzato dell'opzione, le selezioni multiple sono ordinate per indice di opzione e un array vuoto cancella la selezione

Checkbox e gruppi radio richiedono checked booleano; onState vale Yes per default e seleziona il widget radio corrispondente quando fornito esplicitamente, mentre la cancellazione aggiorna sia lo stato del campo sia quello del widget

I push button richiedono caption, disegnata con il font Unicode incorporato selezionato

forms.read include l'array values completo per ogni campo choice, array vuoto compreso dopo la cancellazione; il membro scalare value resta disponibile

Per i campi rich, forms.read restituisce anche la stringa XHTML richText memorizzata; le sostituzioni di valore ordinarie sincronizzano RV e i run stilizzati richiedono la generazione dell'appearance

Opzioni e pubblicazione

Ogni modifica accetta fontFamily (default DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) e paintWhiteBackground (true)

Le modifiche rich tipizzate possono usare anche array fontFamilies e selezione della family per run, conservando il comportamento single-family originale quando l'array è assente

Le modifiche ai campi testo possono impostare esplicitamente appearance:false per aggiornamenti solo-valore; le modifiche a choice e pulsanti richiedono la generazione dell'appearance

Campi sconosciuti, modifiche duplicate, selezioni non valide, valori comb eccessivi, parametri malformati, cancellazione, esaurimento risorse e callback fallite lasciano invariato il documento caricato corrente; l'output viene preparato prima di eseguire qualunque callback di pubblicazione binaria

Il risultato dell'operazione contiene updated e la lista corrente dei campi; si scoprono i tipi di appearance supportati tramite l'array capability formAppearances

La validazione della C ABI nativa genera veri output modulo in plaintext e AES R5/R6; verifiche indipendenti con pypdf e MuPDF ispezionano indici di selezione, stati dei widget, font incorporati, valori Unicode, cifratura e veri pixel delle appearance

C ABI nativa di Linux · Workflow di firma · Piano di consegna restante