Renderovací pipeline

Z dokumentu na obrázky stránek

Mezi OpenDocumentAsync a PNG, která dorazí do prohlížeče, jsou dva odlišné stupně: rozlišení 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 DefaultRender ve skutečnosti přepíná.

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:

  1. Nejprve vlastní prohlížeče. Cokoliv, co jste zaregistrovali pomocí DoconutOptions.RegisterViewer(extension, factory, defaultConfig?), přebije všechny vestavěné.
  2. 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ždou s vlastním adaptérem engine. Pokud licencovaný plugin přidá 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í volba továrny na vestavěný prohlížeč je obranné pravidlo za běhu.
  3. Formáty pouze pro pluginy. Některé přípony nemají vůbec vestavěný prohlížeč — DICOM (.dcm) existuje jen prostřednictvím DICOM pluginu. Otevření takového bez požadované schopnosti vyvolá:
text
LicenseException: This document type requires the 'Dicom' plugin license.

Rozšíření, které nevyžaduje žádný prohlížeč, vyvolá:

text
FormatNotSupportedException: Document format '<extension>' is not supported.

Po rozpoznání je konfigurace ustavena: 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 formát odhaluje 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 PDF prohlížeč přebírá. 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í AllowSearch a AllowCopy pro 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 obsahující text — za cenu předběžné konverze při otevření dokumentu.

Fáze 2 — Pipeline obrázků stránek

Vykreslené stránky jsou zpracovávány na požádání přes pevnou sekvenci:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • Vodoznak — aplikováno ze stavu licence (chybějící licence, vypršená dočasná nebo předplatná, neplatná doména, špatná verze) a z DocOptions.Watermark pro váš vlastní vlastní text. Správně licencovaná aplikace — nebo aktivní dočasná licence — bez vlastního vodoznaku tento krok přeskočí.
  • Rotace/otočení — 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.
  • Měřítko — náhledy a úrovně přiblížení jsou vytvořeny škálováním vykreslené stránky na požadovanou cílovou velikost; 0 znamená podávat v původní velikosti.
  • Vypálení anotací — uložené anotace jsou vykresleny na bitmapu, aby je exporty a obrázky stránek zobrazovaly.
  • 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 dobu trvání relace dokumentu, takže opětovná návštěva stránky nevyžaduje opětovné vykreslení. 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

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 s písmy nainstalovanými na serveru. Na Linuxu nainstalujte knihovnu pro konfiguraci písem před otevřením prvního dokumentu (fontconfig na RHEL a Fedora):

bash
apt-get update && apt-get install -y libfontconfig1

Bez 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í hned po instalaci. 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 chceteLadit
Ostré stránkyImageResolution v konfiguraci formátu
Přesné vyhledávání textu v HTML/EPUB/email/MHT/MPPDefaultRender = false v konfiguraci formátu
Nižší paměť u velkých dokumentůCachePages = false, explicitně uzavřete relace
Vlastní razítko na každé stránceDocOptions.Watermark

Byla tato stránka užitečná?