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:

  1. 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.
  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ž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.
  3. 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:
text
LicenseException: This document type requires the 'Dicom' plugin license.

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

text
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í 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 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:

text
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.Watermark pro 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; 0 znamená 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):

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í 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 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írejte relace
Vlastní razítko na každé stránceDocOptions.Watermark

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