Renderovací pipeline
Z dokumentu na obrázky stránek
Mezi OpenDocumentAsync a PNG, která dorazí do prohlížeče, jsou dva odlišné stupně: rozpoznání prohlížeče (který engine načte dokument, rozhodnuto jednou při otevření) a zpracování stránky (co se děje s každým obrázkem stránky při každém požadavku). Znalost obou vysvětluje, proč se formát vykresluje tak, jak to dělá — a co skutečně přepíná DefaultRender.
Fáze 1 — Rozpoznání prohlížeče formátu
Továrna mapuje příponu souboru na prohlížeč pomocí katalogu formátů, se třemi úrovněmi přednosti:
- Vlastní prohlížeče jako první. Cokoliv, co jste zaregistrovali pomocí
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?), má přednost před všemi vestavěnými. - Vestavěné prohlížeče rodiny. Katalog mapuje každou zobrazitelnou příponu na rodinu prohlížečů — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — každá s vlastním adaptérem engine. Pokud licencovaný plugin poskytne prohlížeč pro stejnou příponu, pluginový prohlížeč nahradí vestavěný.
AddDoconut()ověřuje registrovaná oprávnění pluginů při spuštění; náhradní cesta továrny k vestavěnému prohlížeči je obranné pravidlo za běhu. - Formáty pouze pro pluginy. Některé přípony nemají vůbec vestavěný prohlížeč — DICOM (
.dcm) existuje pouze prostřednictvím DICOM pluginu. Otevření bez požadované schopnosti vyvolá výjimku:
LicenseException: This document type requires the 'Dicom' plugin license.Rozšíření, které neobsahuje žádný prohlížeč, vyvolá:
FormatNotSupportedException: Document format '<extension>' is not supported.Po rozpoznání je konfigurace ustálená: váš explicitní konfigurační objekt, pokud jste jej předali, jinak výchozí konfigurace formátu z katalogu. DocOptions.Password je zkopírován do konfigurace pro chráněné dokumenty.
Fáze 1b — Režim přesměrování (DefaultRender = false)
Většina konfigurací na úrovni formátu vystavuje příznak DefaultRender. Ten vybírá mezi dvěma zásadně odlišnými cestami:
DefaultRender = true— dokument se vykresluje nativně, přímo na obrázky stránek.DefaultRender = false— dokument je nejprve převáděn do PDF v paměti, zdrojový engine je uvolněn a převzet PDF prohlížeč. Vygenerované PDF obsahuje skutečný text, takže full-textové vyhledávání získá pixelově přesné nativní zvýraznění; pipeline vynutí zapnutíAllowSearchaAllowCopypro přesměrované PDF, protože konverze je pro uživatele neviditelná.
XPS a výchozí nastavení katalogu pro MHT používají cestu přesměrování. PDF projekce může poskytnout nativní vyhledávání pro formáty jako HTML a Microsoft Project. Pokud výsledné PDF obsahuje obrázky bez textové vrstvy, standardní prohlížeč nemůže tyto pixely prohledávat.
Použijte režim přesměrování, když potřebujete PDF projekci s textem — za cenu předběžné konverze při otevření dokumentu.
Fáze 2 — Pipeline obrázků stránek
Vykreslené stránky jsou zpracovány na požádání pomocí pevné sekvence:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Vodoznak — aplikován podle stavu licence (chybějící licence, vypršená dočasná nebo předplatná, neplatná doména, špatná verze) a z
DocOptions.Watermarkpro váš vlastní vlastní text. Správně licencovaná aplikace — nebo aktivní dočasná licence — bez vlastního vodoznaku tento krok přeskočí. - Otočení/obrácení — stav na stránce, který uživatel nastaví ve widgetu (90°/180°/270°, horizontální/vertikální převrácení) je uložen v relaci a aplikován při každém dalším vykreslení té stránky.
- Škálování — náhledy a úrovně přiblížení jsou vytvořeny škálováním vykreslené stránky na požadovanou cílovou velikost;
0znamená podávat v původní velikosti. - Vypálení anotací — uložené anotace jsou vykresleny na bitmapu, takže exporty a obrázky stránek je zobrazují.
- Kódování — výsledek je zakódován do PNG pomocí sdílených paměťových streamů a zapsán přímo do HTTP odpovědi.
Chyby uvnitř middleware jsou vráceny jako PNG chybové obrázky (červený text na bílém) místo HTTP chybových stránek, takže widget je může zobrazit v oblasti stránky.
Cache stránek
BaseConfig.CachePages (výchozí true) uchovává vykreslené obrázky stránek v paměti po celou dobu životnosti relace dokumentu, takže opětovná návštěva stránky ji nevyžaduje znovu vykreslit. BaseConfig.ImageResolution (25–300 DPI, 0 = výchozí formátu) je hlavní ovladač kvality/paměti; výchozí hodnota každého formátu je zdokumentována na jeho konfigurační stránce.
Vykreslování na jednom uzlu vs. více uzlech
Vše výše popisuje vykreslování na jednom uzlu na požádání pro relaci, která dokument otevřela. Nasazení, kde jeden uzel vykresluje a publikuje celý soubor artefaktů, a ostatní uzly slouží tyto stránky ze sdíleného úložiště, používá jinou čtecí cestu — viz Distribuovaná nasazení.
Písma na Linuxu
Stránky jsou kresleny pomocí písem nainstalovaných na serveru. Na Linuxu nainstalujte knihovnu pro konfiguraci písem před otevřením prvního dokumentu (fontconfig na RHEL a Fedora):
apt-get update && apt-get install -y libfontconfig1Bez ní selže otevření dokumentu s The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Je to jediný systémový balíček, který Doconut potřebuje; libgdiplus není vyžadován.
Jeho závislosti přinášejí základní sadu písem (DejaVu), takže dokumenty se vykreslí okamžitě. Dokument, který požaduje písmo, které server nemá — Calibri, Arial nebo Times New Roman na typickém Linuxovém obrazu — získá nejbližší nainstalované písmo, takže text může mít jinou šířku a zalomení řádků se může lišit od Windows. Pro výstup blíže k Windows nainstalujte metricky kompatibilní náhrady fonts-liberation, fonts-crosextra-carlito a fonts-crosextra-caladea; přidejte fonts-noto-core nebo fonts-noto-cjk pro jiné skripty, nebo zkopírujte své vlastní soubory .ttf/.otf do /usr/share/fonts/ a spusťte fc-cache -f.
Alpine a další distribuce založené na musl nejsou podporovány.
Kde co ladit
| Co chcete | Ladit |
|---|---|
| Ostré stránky | ImageResolution v konfiguraci formátu |
| Přesné vyhledávání textu v HTML/EPUB/email/MHT/MPP | DefaultRender = false v konfiguraci formátu |
| Nižší paměť u velkých dokumentů | CachePages = false, explicitně uzavírejte relace |
| Vlastní razítko na každé stránce | DocOptions.Watermark |
Byla tato stránka užitečná?