Trasporto delle appearance dei timbri XFDF standard

Le annotazioni timbro possono esportare e importare i loro effettivi stream di appearance PDF e dizionari di risorse attraverso l'elemento appearance di Adobe XFDF

Il profilo stamp-typed-xml-v1 usa XML tipizzato UTF-8 codificato in base64, come descritto dalla specificazione Adobe XFDF 3; il payload decodificato rappresenta oggetti PDF invece di un file PDF o FDF completo

Risorse mappate

Il DICT KEY="AP" di primo livello contiene uno stream Form normal N richiesto e stream rollover R e down D opzionali

I Form conservano il loro BBox finito a quattro numeri, la Matrix opzionale a sei numeri e il grafo di risorse supportato, inclusi i font e i loro programmi incorporati, immagini e soft mask, spazi colore, pattern, shadings, funzioni e stati grafici

I valori tipizzati includono DICT, STREAM, ARRAY, INT, FIXED, NAME, BOOL e NULL; le chiavi dei dizionari e i valori dei nomi preservano i loro nomi PDF semantici, e i token numerici sorgente validi preservano la precisione decimale

Il DATA degli stream supporta MODE="RAW" o MODE="FILTERED" con ENCODING="HEX" o ENCODING="ASCII" a sette bit; RAW conserva i byte codificati e il loro Filter/DecodeParms, mentre FILTERED installa byte decodificati senza metadati di filtraggio obsoleti

L'export usa dati esadecimali RAW e rigenera il Length dello stream dai byte effettivi; gli stream cifrati autenticati vengono decodificati o decifrati prima dello scambio e cifrati correttamente nella revisione salvata

Le risorse condivise acicliche vengono espanse come valori equivalenti e importate con riferimenti a oggetti indipendenti; questo profilo non preserva l'identità dei riferimenti

I byte dei programmi di font incorporati e i loro flag di incorporamento vengono preservati senza cambiare i bit di licenza né sostituire un programma di font diverso

API e callback

Usare HPDFExportHeadlessAnnotationsXFDF e SaveAnnotationsXFDFToFile per le transazioni native, oppure gli overload limitati di HPDFXFDFExportAnnotations e HPDFXFDFImportAnnotations per gli adattatori di grafo owned dal caller

I file job Windows e callback V1 e i callback V1 Linux esistenti usano le loro operazioni di annotazioni e layout di record esistenti

Le capabilities conservano appearanceImport=false per le appearance generali delle annotazioni e aggiungono stampAppearanceImport=true, appearanceProfile="stamp-typed-xml-v1", appearanceTypes=["stamp"], appearanceDataModes=["RAW","FILTERED"], appearanceEncodings=["ASCII","HEX"] e appearanceResources="acyclic-expanded-graph"

Transazioni e limiti

XML di input, base64, nomi, codifica degli stream, tipi di risorse, chiavi semantiche dei dizionari e geometria dei Form vengono validati prima della pubblicazione; dati malformed, cicli, limiti cumulativi esauriti o cancellazione fanno fallire l'intera transazione

I limiti XFDF coprono input/output totale, nodi XML e di grafo, profondità, archiviazione degli stream e prenotazioni di lavoro attraverso l'operazione di annotazioni

L'import conserva lo stato di grafo non salvato corrente, la sicurezza AES R5/R6 e le restrizioni autenticate di certificazione; P1/P2 negano le modifiche alle annotazioni e P3 preserva il prefisso firmato originale e la genuina integrità della firma

Un import vuoto autorizzato restituisce zero e preserva i byte PDF correnti esatti quando non ci sono modifiche non salvate; le modifiche del grafo dirty vengono salvate senza essere scartate

I contesti callback di Windows e Linux adottano un PDF preparato solo dopo che l'output PDF, l'output del risultato JSON e la verifica finale di cancellazione hanno successo; i callback falliti o parziali conservano il contesto precedente, e il primo writer fallito resta sticky

L'import di sole annotazioni accetta contenitori fields vuoti e dichiarazioni di campi senza valore come metadati no-op; i valori di modulo effettivi e gli aggiornamenti dei campi rich richiedono la separata operazione autenticata dei dati modulo

Lavoro restante

Il trasporto AP generale delle annotazioni, i dizionari di stato delle appearance, i valori delle risorse stringa, i riferimenti DEFINE/REF non vuoti, i grafi ciclici, Redact overlayappearance, la sostituzione/rimozione delle annotazioni e lo scambio FDF delle annotazioni restano lavoro separato

Le annotazioni geometriche e di testo senza un'appearance di timbro trasportata conservano il comportamento esistente; questa operazione non sintetizza appearance arbitrarie delle annotazioni né esegue azioni

L'adattatore limitato condiviso riserva chiavi di annotazione raw e grafi AP espansi prima della conversione del payload, e riserva lo spazio bianco base64 e il DATA decodificato prima di allocare quelle rappresentazioni; la conversione dei nomi PDF usa passate lineari con checkpoint di cancellazione