Renderingspipeline

Från dokument till sidbilder

Mellan OpenDocumentAsync och PNG‑filen som når webbläsaren finns två tydliga steg: visningsupplösning (vilken motor som laddar dokumentet, bestäms en gång per öppning) och sidbearbetning (vad som händer med varje sidbild vid varje begäran). Att förstå båda förklarar varför ett format renderas som det gör — och vad DefaultRender egentligen byter.

Steg 1 — Upplösning av formatvisaren

  1. Anpassade visare först. Allt du registrerade med DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) har företräde framför alla inbyggda.
  2. Inbyggda familjevisare. Katalogen mappar varje visningsbar filändelse till en visarfamilj — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — var och en med sin egen motoradapter. Om ett licensierat plugin bidrar med en visare för samma filändelse ersätter plugin‑visaren den inbyggda. AddDoconut() validerar registrerade plugin‑behörigheter vid start; fabrikens återgång till den inbyggda visaren är en defensiv körningsregel.
  3. Endast plugin‑format. Vissa filändelser har ingen inbyggd visare alls — DICOM (.dcm) finns bara via DICOM‑pluginet. Att öppna en sådan utan den nödvändiga kapaciteten kastar:
text
LicenseException: This document type requires the 'Dicom' plugin license.

En filändelse utan någon visare ger:

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

Efter upplösning är konfigurationen fastställd: ditt explicita konfigurationsobjekt om du skickade ett, annars formatets standardkonfiguration från katalogen. DocOptions.Password kopieras in i konfigurationen för skyddade dokument.

Steg 1b — Omdirigeringsläge (DefaultRender = false)

De flesta per‑formatkonfigurationer exponerar en DefaultRender‑flagga. Den väljer mellan två fundamentalt olika vägar:

  • DefaultRender = true — dokumentet renderas nativt, direkt till sidbilder.
  • DefaultRender = false — dokumentet konverteras först till en PDF i minnet, källmotorn frigörs, och en PDF‑visare tar över. Den genererade PDF‑filen bäddar in riktig text, så fulltextsökning får pixel‑exakta nativa markeringar; pipelinen tvingar på AllowSearch och AllowCopy för den omdirigerade PDF‑filen eftersom konverteringen är osynlig för användaren.

XPS och katalogens standard för MHT använder omdirigeringsvägen. En PDF‑projektion kan ge inbyggd sökning för format som HTML och Microsoft Project. Om den resulterande PDF‑filen innehåller bilder utan ett textlager kan den vanliga visaren inte söka i dessa pixlar.

Använd omdirigeringsläge när du behöver en PDF‑projektion med text — på bekostnad av en förhandskonvertering när dokumentet öppnas.

Steg 2 — Sid‑bildspipelinen

Renderade sidor bearbetas per begäran genom en fast sekvens:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • Vattenstämpel — appliceras från licenstillståndet (saknad licens, utgången temporär eller prenumeration, ogiltig domän, fel version) och från DocOptions.Watermark för din egen anpassade text. En korrekt licensierad app — eller en aktiv temporär licens — utan anpassad vattenstämpel hoppar över detta steg.
  • Rotera/vända — per‑sidstatus som användaren ställer in i widgeten (90°/180°/270°, horisontella/vertikala vändningar) lagras i sessionen och appliceras på varje efterföljande rendering av den sidan.
  • Skala — miniatyrer och zoomnivåer produceras genom att skala den renderade sidan till den begärda målstorleken; 0 betyder att leverera i originalstorlek.
  • Anmärkning bränning — sparade anmärkningar ritas på bitmapen så export och sidbilder visar dem.
  • Kodning — resultatet kodas till PNG med poolade minnesströmmar och skrivs direkt till HTTP‑svaret.

Fel i middleware returneras som PNG‑felbilder (röd text på vit bakgrund) istället för HTTP‑felssidor, så widgeten kan visa dem i sidområdet.

Sidcachning

BaseConfig.CachePages (standard true) behåller renderade sidbilder i minnet under hela dokumentsessionens livstid, så att återbesök av en sida inte renderas om. BaseConfig.ImageResolution (25–300 DPI, 0 = formatstandard) är den huvudsakliga kvalitet/minne‑reglaget; varje formats standard är dokumenterad på dess konfigurationssida.

Rendering på en nod vs. flera

Allt ovan beskriver rendering på en enskild nod på begäran för den session som öppnade dokumentet. En distribution där en nod renderar och publicerar hela artefaktsättet, och andra noder serverar dessa sidor från delat lagringsutrymme, använder en annan läsväg — se Distribuerade distributioner.

Typsnitt på Linux

Sidor ritas med de typsnitt som är installerade på servern. På Linux, installera fontkonfigurationsbiblioteket innan det första dokumentet öppnas (fontconfig på RHEL och Fedora):

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

Utan det misslyckas öppning av ett dokument med The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Det är det enda systempaketet Doconut behöver; libgdiplus krävs inte.

Dess beroenden medför en grundläggande typsnittssamling (DejaVu), så dokument renderas direkt. Ett dokument som begär ett typsnitt som servern inte har — Calibri, Arial eller Times New Roman på en typisk Linux‑image — får istället det närmaste installerade typsnittet, så text kan få annan bredd och radbrytningar kan skilja sig från Windows. För output som ligger närmare Windows, installera de metrisk‑kompatibla ersättarna fonts-liberation, fonts-crosextra-carlito och fonts-crosextra-caladea; lägg till fonts-noto-core eller fonts-noto-cjk för andra skript, eller kopiera dina egna .ttf/.otf‑filer till /usr/share/fonts/ och kör fc-cache -f.

Alpine och andra musl‑baserade distributioner stöds inte.

Var man justerar vad

Du villJustera
Skarpare sidorImageResolution i formatkonfigurationen
Noggrann textsökning på HTML/EPUB/e‑post/MHT/MPPDefaultRender = false i formatkonfigurationen
Lägre minnesanvändning på stora dokumentCachePages = false, stäng sessioner explicit
Egen stämpel på varje sidaDocOptions.Watermark

Var den här sidan hjälpsam?