Pipeline di Rendering
Dal documento alle immagini delle pagine
Tra OpenDocumentAsync e il PNG che arriva al browser ci sono due fasi distinte: risoluzione del visualizzatore (che motore carica il documento, deciso una volta per apertura) e elaborazione della pagina (cosa succede a ogni immagine di pagina ad ogni richiesta). Conoscere entrambe spiega perché un formato viene renderizzato in un certo modo — e cosa DefaultRender cambia realmente.
Fase 1 — Risoluzione del visualizzatore di formato
La fabbrica associa l'estensione del file a un visualizzatore tramite il catalogo dei formati, con tre livelli di precedenza:
- Prima i visualizzatori personalizzati. Qualsiasi cosa tu abbia registrato con
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)prevale su tutti i visualizzatori integrati. - Visualizzatori di famiglia integrati. Il catalogo associa ogni estensione visualizzabile a una famiglia di visualizzatori — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — ognuna con il proprio adattatore di motore. Se un plugin con licenza contribuisce con un visualizzatore per la stessa estensione, il visualizzatore del plugin sostituisce quello integrato.
AddDoconut()convalida i diritti del plugin registrati all'avvio; il fallback della fabbrica al visualizzatore integrato è una regola difensiva a runtime. - Formati solo plugin. Alcune estensioni non hanno alcun visualizzatore integrato — DICOM (
.dcm) esiste solo tramite il plugin DICOM. Aprirne uno senza la capacità richiesta genera:
LicenseException: This document type requires the 'Dicom' plugin license.Un'estensione non rivendicata da alcun visualizzatore genera:
FormatNotSupportedException: Document format '<extension>' is not supported.Dopo la risoluzione, la configurazione è stabilita: il tuo oggetto di configurazione esplicito se ne hai fornito uno, altrimenti la configurazione predefinita del formato dal catalogo. DocOptions.Password viene copiato nella configurazione per i documenti protetti.
Fase 1b — Modalità di reindirizzamento (DefaultRender = false)
La maggior parte delle configurazioni per formato espone un flag DefaultRender. Seleziona tra due percorsi fondamentalmente diversi:
DefaultRender = true— il documento viene renderizzato nativamente, direttamente in immagini di pagina.DefaultRender = false— il documento è prima convertito in un PDF in memoria, il motore sorgente viene rilasciato e un visualizzatore PDF prende il controllo. Il PDF generato incorpora testo reale, così la ricerca a testo completo ottiene evidenziazioni native precise a livello di pixel; la pipeline forzaAllowSearcheAllowCopyattivi per il PDF reindirizzato poiché la conversione è invisibile all'utente.
XPS e il valore predefinito del catalogo per MHT utilizzano il percorso di reindirizzamento. Una proiezione PDF può fornire ricerca nativa per formati come HTML e Microsoft Project. Se il PDF risultante contiene immagini senza uno strato di testo, il visualizzatore standard non può cercare quei pixel.
Usa la modalità di reindirizzamento quando ti serve una proiezione PDF con testo — al costo di una conversione iniziale quando il documento si apre.
Fase 2 — La pipeline di immagini di pagina
Le pagine renderizzate vengono elaborate per richiesta attraverso una sequenza fissa:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Filigrana — applicata dallo stato della licenza (licenza mancante, temporanea scaduta o abbonamento, dominio non valido, versione errata) e da
DocOptions.Watermarkper il tuo testo personalizzato. Un'app correttamente licenziata — o una licenza Temporanea attiva — senza filigrana personalizzata salta questo passaggio. - Ruota/Capovolgi — lo stato per pagina impostato dall'utente nel widget (90°/180°/270°, capovolgimenti orizzontali/verticali) è memorizzato nella sessione e applicato a ogni successiva renderizzazione di quella pagina.
- Scala — le miniature e i livelli di zoom sono prodotti scalando la pagina renderizzata alla dimensione target richiesta;
0significa servire alla dimensione originale. - Integrazione annotazioni — le annotazioni salvate sono disegnate sul bitmap così le esportazioni e le immagini di pagina le mostrano.
- Codifica — il risultato è codificato in PNG usando stream di memoria condivisi e scritto direttamente nella risposta HTTP.
Gli errori all'interno del middleware vengono restituiti come immagini di errore PNG (testo rosso su bianco) anziché pagine di errore HTTP, così il widget può visualizzarle nell'area della pagina.
Cache delle pagine
BaseConfig.CachePages (predefinito true) mantiene le immagini delle pagine renderizzate in memoria per tutta la durata della sessione del documento, così la visita di una pagina non la ri-renderizza. BaseConfig.ImageResolution (25–300 DPI, 0 = predefinito del formato) è il principale controllo qualità/memoria; il predefinito di ogni formato è documentato nella sua pagina di configurazione.
Rendering su un nodo vs. molti
Tutto quanto sopra descrive il rendering su un singolo nodo su richiesta per la sessione che ha aperto il documento. Un'installazione in cui un nodo renderizza e pubblica l'intero set di artefatti, e gli altri nodi servono quelle pagine da storage condiviso, utilizza un percorso di lettura diverso — vedi Distribuzioni distribuite.
Font su Linux
Le pagine sono disegnate con i font installati sul server. Su Linux, installa la libreria di configurazione dei font prima che il primo documento si apra (fontconfig su RHEL e Fedora):
apt-get update && apt-get install -y libfontconfig1Senza di essa, l'apertura di un documento fallisce con The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. È l'unico pacchetto di sistema di cui Doconut ha bisogno; libgdiplus non è richiesto.
Le sue dipendenze forniscono un set di font di base (DejaVu), così i documenti vengono renderizzati subito. Un documento che richiede un font che il server non possiede — Calibri, Arial o Times New Roman su una tipica immagine Linux — ottiene il font installato più vicino, quindi il testo può avere una larghezza diversa e le interruzioni di riga possono differire da Windows. Per un output più vicino a Windows, installa i sostituti metricamente compatibili fonts-liberation, fonts-crosextra-carlito e fonts-crosextra-caladea; aggiungi fonts-noto-core o fonts-noto-cjk per altri script, o copia i tuoi file .ttf/.otf in /usr/share/fonts/ ed esegui fc-cache -f.
Alpine e altre distribuzioni basate su musl non sono supportate.
Dove regolare cosa
| Cosa vuoi | Regola |
|---|---|
| Pagine più nitide | ImageResolution nella configurazione del formato |
| Ricerca testuale accurata su HTML/EPUB/email/MHT/MPP | DefaultRender = false nella configurazione del formato |
| Meno memoria su documenti enormi | CachePages = false, chiudere esplicitamente le sessioni |
| Il tuo timbro su ogni pagina | DocOptions.Watermark |
Questa pagina è stata utile?