Prestandaoptimering

Optimera rendering och minne

Doconuts resursprofil domineras av tre saker: render DPI, vad som hålls i cache, och hur länge sessioner lever. Den här guiden går igenom spakarna i ordning efter påverkan.

Upplösning — den största spaken

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

csharp
// En förhandsgranskning av dokumentlistan behöver inte ha 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 zoomtunga användningsfall (CAD, ingenjörsritningar).

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

  • dokumenten ä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 förhandsladdar ViewerConfig.CacheEnabled = true ett litet rörligt fönster av kommande sidbilder i webbläsarens minne. Det är en per‑visning förhämtningcache, 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 ut inaktivitetsfönstret.
  • Anpassa timeouten. En förhandsvisning 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.
  • Omdirigeringsläge 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‑probning och felaktiga mått; peka FontFolders på en katalog med dina typsnitt.
  • Presentationer på Linux: ingen libgdiplus eller System.Drawing.EnableUnixSupport‑växel behövs — se Fonts on Linux.

Klientsidstrategier

  • LargeDoc = true — strategi för lat laddning av 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örhandsvisningar.
  • Att aktivera FixedZoom undviker fria zoomändringar; 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 och hållet 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 spak inte en större ratt — det är att publicera ett dokuments artefakter en gång till delat lagringsutrymme och låta varje nod tjäna 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 Distributed Deployments.

En justeringschecklista

  1. Ställ in den lägsta ImageResolution som din UX accepterar.
  2. Håll CachePages på för interaktiv visning; avstängd för engångs‑ eller högkonkurrensscenarier.
  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?