Ladění výkonu

Optimalizace vykreslování a paměti

Profil zdrojů Doconut je ovládán třemi věcmi: DPI vykreslování, co zůstává v keši, a jak dlouho relace žijí. Tento průvodce prochází pákami v pořadí dopadu.

Rozlišení — největší páka

ImageResolution (25–300 DPI) určuje jak dobu vykreslování, tak velikost obrázku. Většina formátů má výchozí 200 DPI; obrázky a PSD mají výchozí 100.

csharp
// A document list preview doesn't need print quality
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Poloviční DPI přibližně čtyřnásobně snižuje počet pixelů na stránku — rychlejší vykreslování, menší přenosy, méně paměti pro keš. Vyhraďte 250–300 DPI pro případy s intenzivním přiblížením (CAD, technické výkresy).

Pro PDF s velkým množstvím vložených obrázků PdfConfig přidává jemnější ovládací prvky: CompressImages + CompressQuality, ResizeImages + ResizeResolution a CompressFast. Pro běžné obrázky omezuje ImageConfig.MaxImagePixelSize (výchozí 3000 px) výstupní velikost.

Kešování stránek — paměť vs. opětovné vykreslení

BaseConfig.CachePages (výchozí true) uchovává každou vykreslenou stránku v paměti po celou dobu životnosti relace. To je správné výchozí nastavení pro interaktivní prohlížení — uživatelé posouvají dopředu i dozadu. Vypněte jej, když:

  • dokumenty jsou obrovské a jsou prohlíženy jednou, od začátku do konce,
  • mnoho souběžných relací by násobilo počet kešovaných stránek,
  • raději zaplatíte CPU za každé zobrazení než budete držet RAM.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

Na klientovi ViewerConfig.CacheEnabled = true přednačítá malé posouvající se okno nadcházejících obrázků stránek v paměti prohlížeče. Jedná se o keš přednačtení na úrovni zobrazení, nikoli trvalý localStorage.

Relace — paměť, kterou nevidíte

Každá otevřená relace drží parsovaný model dokumentu plus (s CachePages) jeho vykreslené stránky, dokud neuplyne posuvný TimeOut (výchozí 60 minut) od posledního požadavku. Dvě návyky udržují toto pod kontrolou:

  • Zavřete, s čím jste skončili. viewer.CloseDocument(token) okamžitě uvolní engine místo čekání na nečinnost.
  • Správně nastavte časový limit. Náhled, na který se uživatelé podívají dva minuty, nepotřebuje hodinovou relaci:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Pamatujte na kompromis: po vypršení časového limitu widget zobrazí Document session not found. Please re-open document. — zvolte časový limit, který odpovídá skutečným čtecím relacím.

Formátově specifické přepínače

  • Excel: MemoryOptimizationPreference je ve výchozím nastavení zapnutý a snižuje paměťovou stopu při vykreslování velmi velkých sešitů — nechte jej zapnutý, nebo jej nastavte na false, pokud chcete vyměnit paměť za malý nárůst rychlosti; SheetNames / PrintArea omezují vykreslování na podstatné části.
  • Režim přesměrování má počáteční náklad: DefaultRender = false převádí celý dokument do PDF při otevření. Získává nativní textové vyhledávání, ale u 500stránkového dokumentu volání otevření nese tuto konverzi — neaktivujte jej reflexivně.
  • Word/PPT na Linux/Docker: chybějící fonty způsobují pomalé hledání náhrad a špatné metriky; nasměrujte FontFolders na adresář s vašimi fonty.
  • Prezentace na Linux/macOS: soubory PPT/PPTX/PPS/POT/ODP lze otevřít, ale vykreslování současným prezentačním enginem vyžaduje nativní libgdiplus a přepínač runtime System.Drawing.EnableUnixSupport=true. Ostatní formátové rodiny používají běžnou multiplatformní cestu vykreslování.

Strategie na straně klienta

  • LargeDoc = true — strategie lazy‑load pro velmi velké dokumenty; stránky se načítají, jak se uživatel k nim přibližuje.
  • AutoLoad = false (výchozí) — nevykreslujte, dokud nevoláte View(token).
  • ShowThumbs = false — vynechte generování/požadavky na miniatury u jednostránkových nebo vložených náhledů.
  • Povolení FixedZoom zabraňuje volným změnám přiblížení; když mapujete C# ViewerConfig, nastavte FixedZoomPercentMobile (výchozí C# 75) pro malé obrazovky.

Spuštění jednou, ne při každém požadavku

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) patří do Program.cs — registrace kódování při každém požadavku je zbytečná práce; úplné zapomenutí rozbije starší dokumenty s kódovými stránkami.

Kontrolní seznam ladění

  1. Nastavte nejnižší ImageResolution, kterou vaše UX akceptuje.
  2. Nechte CachePages zapnuté pro interaktivní prohlížení; vypněte jej pro jednorázové nebo scénáře s vysokou souběžností.
  3. Explicitně zavírejte relace; zkracujte TimeOut, kde je používání burstové.
  4. Použijte LargeDoc + výchozí AutoLoad = false na klientovi pro velké dokumenty.
  5. Používejte DefaultRender = false pouze když potřebujete PDF projekci s textem.

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