Gestori di Documenti Opzionali

THPDFDocumentHandlerRegistry seleziona i gestori sostituibili in base al contenuto ispezionato prima degli hint deboli su estensione o MIME, quindi converte la sorgente selezionata in una cache PDF immutabile condivisa da esportazione e rendering

Handler opzionali integrati

• XPS e OpenXPS conservano le dimensioni a pagina fissa e l'ordine visivo, convertono abbreviazioni a chiusura automatica o con proprietà in Path geometria in vettori PDF nativi, preservano brush solidi da attributo o elemento proprietà, multi-stop LinearGradientBrush ed ellittiche RadialGradientBrush pattern di shading, e riempiono i percorsi attraverso JPEG, PNG, TIFF o JPEG XR del pacchetto ImageBrush risorse con TileMode=None
• I fill immagine XPS supportano RelativeToBoundingBox Viewbox e Viewport mapping, None, Tile, FlipX, FlipY e FlipXY modalità di tile, clipping nativo di percorso e piazzamento, sei attributi finiti Transform attributi o ImageBrush.Transform MatrixTransform elementi, opacità di brush e percorso, alpha soft-mask PNG, DPI delle immagini e caching delle risorse del pacchetto
• XPS Path.OpacityMask supporta maschere a gradiente solido, lineare multi-stop o radiale ellittico, e PNG ImageBrush , incluse celle di immagine ripetute e riflesse; l'alpha uniforme viene ripiegata negli stati grafici esistenti mentre l'alpha variabile usa gruppi di trasparenza DeviceGray nativi limitati che condividono pattern di shading e stream soft-mask delle immagini
• Canvas XPS Opacity e Canvas.OpacityMask compongono una sola volta i discendenti sovrapposti attraverso Form XObject DeviceRGB isolati invece di attenuare ogni figlio indipendentemente; l'alpha uniforme della maschera viene ripiegata nello stato del gruppo, l'alpha variabile da gradiente o immagine PNG riusa risorse soft-mask native, e i gruppi annidati conservano clip trasformati, proprietà delle risorse e annotazioni link limitate entro i limiti di 4.096 gruppi e 16 MiB di contenuto catturato per gruppo
• VisualBrush di XPS converte ricorsivamente i visual Canvas, Path e Glyphs inline o basati su risorse, risolve gli scope annidati e remoti di ResourceDictionary, mappa un Viewbox assoluto su un Viewport assoluto o relativo e riusa un solo Form XObject PDF limitato per posizionamenti diretti, a tessere e riflessi
• XPS Canvas.Clip accetta geometria abbreviata limitata, locali o remoti StaticResource PathGeometry valori, ed elementi proprietà diretti con figure strutturate a linee, Bézier, quadratiche o archi, trasformazioni di geometria, geometria vuota e EvenOdd oppure NonZero regole di fill; i clip annidati diventano W* oppure W percorsi, i rettangoli di navigazione vengono intersecati con i bounds trasformati attivi del clip, il parsing è limitato a 100.000 valori numerici, e i clip malformati o singolari falliscono in modo chiuso prima che i visual figli vengano disegnati
• Glyphs di XPS accetta al massimo 65.536 mapping Indices rigorosi e mantiene la progressione dei cluster uno-a-molti e molti-a-uno, gli advance espliciti in centesimi di em, gli offset orizzontali e verticali, la progressione inversa per BidiLevel dispari, i riempimenti solid come attributo o property element, l'opacità, l'estrazione Unicode e una diagnostica fail-closed per input malformato; le run semplici usano array TJ nativi di PDF e i buffer di mapping di grandi dimensioni crescono con costo lineare ammortizzato
• Le risorse FontUri del package supportano programmi TrueType e OpenType, frammenti di membri TTC e font XPS offuscati con GUID; ID di glifo esatti, run derivate dalla cmap, cluster, advance, offset, origini RTL, riuso delle risorse font, permessi di embedding, subsetting opzionale e mappe di estrazione ToUnicode restano dati di font PDF nativi, senza sostituzione GDI
• XPS FixedPage.NavigateUri su trasformate Path e Glyphs visual diventa un'annotazione link PDF nativa con bounds derivati dalla geometria o dalle metriche; i link HTTP, HTTPS e mail restano azioni URI, mentre le pagine relative al pacchetto e le LinkTarget con percent-decoding diventano azioni GoTo in avanti o all'indietro dopo che ogni pagina è disponibile
• Una Canvas FixedPage.NavigateUri diventa il target ereditato di ogni discendente Path, Glyphs, o visual Canvas annidati finché un discendente non fornisce il proprio URI; i target con ambito si ripristinano dopo override annidati, seguono la geometria e la trasformazione di ogni visual, restano vincolati dai clip Canvas attivi, sopravvivono alla cattura dei gruppi di opacità isolati e restano soppressi dentro i VisualBrush Forms
• La navigazione è limitata a 65.536 link con 8.192 caratteri per URI, controllata per la cancellazione durante la pubblicazione, soppressa durante la cattura VisualBrush riutilizzabile, e rifiutata per caratteri di controllo, scheme non sicuri, target mancanti o mismatch di percorso e frammento
• Non standard RelativeTransform, risorse matrice irrisolte, spread del gradiente Repeat o Reflect, interpolazione non sRGB, paint brush con alpha variabile, conversione di colore, stroke di immagini, i VisualBrush viewbox, simulazione di stile, glifi laterali e proprietà di stroke avanzate restano diagnostici espliciti
• L'EPUB risolve container.xml, il manifest e l'ordine del spine, poi usa l'importatore HTML5 paged-media limitato con risorse del pacchetto solo tramite callback
• CBZ riconosce le voci immagine supportate, applica un ordine determinato dai nomi file naturali e crea una pagina per immagine alla DPI dell'immagine configurata

Budget e isolamento dei guasti

Una singola scansione validata della directory centrale ZIP applica limiti su voci, byte compressi, byte espansi, per voce, cifratura, percorsi duplicati, percorsi non sicuri e rapporto di compressione prima della conversione

Le entry PKZIP ZipCrypto classiche possono richiedere le credenziali tramite ArchivePasswordCallback; il callback riceve il nome della sorgente, il nome della entry e il numero di tentativo (a partire da uno), mentre MaxPasswordAttempts limita i tentativi da 1 a 16

Le credenziali e i byte delle voci parzialmente decodificati restano in memoria e vengono svuotati tra i tentativi, la cancellazione viene controllata prima e dopo ogni callback, e callback mancanti, credenziali rifiutate, tentativi esauriti o cifratura non supportata falliscono in modo chiuso

ZipCrypto è protezione a password legacy piuttosto che cifratura autenticata moderna, e le convenzioni dei byte delle password non ASCII possono variare tra i producer ZIP

Le entry protette da password richiedono Delphi 12 o successivo, il cui System.Zip espone l'hook di decifratura; compilati con una versione Delphi precedente, gli handler leggono ancora le entry non cifrate ma rifiutano quelle cifrate come non supportate prima che ArchivePasswordCallback venga chiamato

Le entry le cui dimensioni o offset richiedono campi ZIP64 richiedono Delphi 11 o successivo; le versioni Delphi precedenti le rifiutano come non supportate

I limiti di risorse, reflow, pagina, pixel, DPI, output e cancellazione restano attivi per tutta la conversione e il rendering, mentre la pubblicazione fallita dell'output ripristina uno stream di destinazione riposizionabile

Registrazione e utilizzo

var
  Registry: THPDFDocumentHandlerRegistry;
  Options: THPDFDocumentHandlerOptions;
  Handled: IHPDFHandledDocument;
  Info: THPDFDocumentHandlerInfo;
begin
  Registry:= THPDFDocumentHandlerRegistry.Create;
  try
    Registry.RegisterStandardHandlers;
    Options:= THPDFDocumentHandlerOptions.Default;
    if Registry.OpenFromFile('book.epub', '', Options, Handled, Info) then
      Handled.WritePDF(OutputStream, Options, Info);
  finally
    Registry.Free;
  end;
end;

API correlate

• THPDFDocumentHandlerRegistry
• IHPDFDocumentHandler
• IHPDFHandledDocument
• THPDFDocumentHandlerOptions
• Importazione HTML5 paged-media