Prestandaoptimering

Optimera rendering och minne

Doconut's resursprofil domineras av tre saker: render DPI, vad som hålls i cache, och hur länge sessioner lever. Denna guide går igenom reglagen i ordning efter påverkan.

Upplösning — det största reglaget

ImageResolution (25–300 DPI) styr både renderingtiden och bildstorleken. De flesta format har standard 200 DPI; bilder och PSD har standard 100.

csharp
// En förhandsgranskning av dokumentlistan behöver inte utskriftskvalitet
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Att halvera DPI minskar ungefär pixelantalet per sida till en fjärdedel — snabbare rendering, mindre överföringar, mindre cacheminne. Reservera 250–300 DPI för zoomintensiva användningsfall (CAD, ingenjörsritningar).

För PDF-filer med tung inbäddad grafik, PdfConfig lägger till finare reglage: CompressImages + CompressQuality, ResizeImages + ResizeResolution, och CompressFast. För vanliga bilder, ImageConfig.MaxImagePixelSize (standard 3000 px) begränsar utskriftsstorleken.

Sidcachning — minne vs. återrendering

BaseConfig.CachePages (standard true) behåller varje renderad sida i minnet under sessionens livstid. Det är rätt standard för interaktiv visning — användare scrollar fram och tillbaka. Stäng av den när:

  • dokument är enorma och visas en gång, från början till slut,
  • många samtidiga sessioner skulle multiplicera de cachade sidorna,
  • du föredrar att betala CPU per visning snarare än att hålla RAM.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

På klienten, ViewerConfig.CacheEnabled = true förladdar ett litet rörligt fönster av kommande sidbilder i webbläsarens minne. Det är en per‑visning förhandsladdningscache, inte en bestående localStorage.

Sessioner — minnet du inte ser

Varje öppen session håller den parsade dokumentmodellen plus (med CachePages) dess renderade sidor, tills den glidande TimeOut (standard 60 minuter) löper ut sedan den senaste begäran. Två vanor håller detta under kontroll:

  • Stäng det du är klar med. viewer.CloseDocument(token) frigör motorn omedelbart istället för att vänta på den inaktiva perioden.
  • Anpassa timeouten. En förhandsgranskning som användare tittar på i två minuter behöver inte en timmes session:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Kom ihåg avvägningen: efter utgången visar widgeten Document session not found. Please re-open document. — välj en timeout som matchar faktiska lässessioner.

Format‑specifika växlar

  • Excel: MemoryOptimizationPreference är på som standard och minskar minnesavtrycket vid rendering av mycket stora arbetsböcker — låt den vara på, eller sätt den till false om du vill byta minne mot en liten hastighetsökning; SheetNames / PrintArea begränsar rendering till det som är viktigt.
  • Redirect‑läget har en initial kostnad: DefaultRender = false konverterar hela dokumentet till PDF vid öppning. Det ger inbyggd textbaserad sökning, men på ett 500‑sidigt dokument innebär öppningsanropet den konverteringen — aktivera det inte reflexivt.
  • Word/PPT på Linux/Docker: saknade typsnitt orsakar långsam fallback‑sökning och felaktiga mått; peka FontFolders mot en katalog med dina typsnitt.
  • Presentationer på Linux: ingen libgdiplus eller System.Drawing.EnableUnixSupport växel behövs — se Typsnitt på Linux.

Klientsidstrategier

  • LargeDoc = true — lat laddningsstrategi för mycket stora dokument; sidor laddas när användaren närmar sig dem.
  • AutoLoad = false (standard) — rendera inte förrän du faktiskt anropar View(token).
  • ShowThumbs = false — hoppa över miniatyrgenerering/förfrågningar för enkelsidiga eller inbäddade förhandsgranskningar.
  • Att aktivera FixedZoom undviker fri zoomning; när du mappar en C# ViewerConfig, justera FixedZoomPercentMobile (C# standard 75) för små skärmar.

Starta en gång, inte per begäran

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) hör hemma i Program.cs — att registrera kodningar per begäran är slöseri; att glömma det helt förstör äldre kodsidokument.

Sprida arbetet över noder

Allt ovan justerar rendering på en enskild nod på begäran. När en enda nod inte kan absorbera belastningen är nästa reglage inte en större vridning — det är att publicera ett dokuments artefakter en gång till delad lagring och låta varje nod leverera dem. Det förändrar kostnadsmodellen: rendering sker en gång per dokument istället för en gång per session, och sidförfrågningar blir fil‑läsningar. Se Distribuerade distributioner.

En justeringschecklista

  1. Ställ in den lägsta ImageResolution som din UX accepterar.
  2. Behåll CachePages på för interaktiv visning; av för engångs‑ eller högkonkurrens‑scenarier.
  3. Stäng sessioner explicit; förkorta TimeOut där användning är burstig.
  4. Använd LargeDoc + standard AutoLoad = false på klienten för stora dokument.
  5. Använd DefaultRender = false endast när du behöver en textbärande PDF‑projektion.

Var den här sidan hjälpsam?