Ladění výkonu

Optimalizace vykreslování a paměti

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

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

ImageResolution (25–300 DPI) řídí jak čas 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
// Náhled seznamu dokumentů nepotřebuje tiskovou kvalitu
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Poloviční DPI přibližně čtvrtí 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ádání: CompressImages + CompressQuality, ResizeImages + ResizeResolution a CompressFast. Pro běžné obrázky ImageConfig.MaxImagePixelSize (výchozí 3000 px) omezuje velikost výstupu.

Kešování stránek — paměť vs. pře‑vykreslování

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 to, když:

  • dokumenty jsou obrovské a jsou prohlíženy jednorázově, 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é posuvné okno nadcházejících obrázků stránek v paměti prohlížeče. Jedná se o keš přednačtení pro konkrétní 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) uvolní engine okamžitě místo čekání na nečinné okno.
  • Správně nastavte časový limit. Náhled, na který se uživatelé podívají dvě 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át‑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 nastavte na false, pokud chcete vyměnit paměť za malý nárůst rychlosti; SheetNames / PrintArea omezují vykreslování na to, co je podstatné.
  • 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 500‑stránkového dokumentu otevření zahrnuje tuto konverzi — neaktivujte jej reflexivně.
  • Word/PowerPoint na serveru bez fontů dokumentů: Windows Server bez Office má mnohem méně fontů než vývojová stanice. Chybějící fonty způsobují pomalé hledání náhrad a špatné metriky; nainstalujte fonty, nebo nasměrujte FontFolders na složku, která je obsahuje.

Strategie na straně klienta

  • LargeDoc = true — strategie líného načítání pro velmi velké dokumenty; stránky se načítají, jak se uživatel k nim přibližuje.
  • AutoLoad = false (výchozí) — nevykreslujte, dokud skutečně nevoláte View(token).
  • ShowThumbs = false — přeskočte generování/požadavky na miniatury pro jednostránkové nebo vložené náhledy.
  • 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í na to rozbije starší dokumenty s kódováním.

Rozdělení práce mezi uzly

Vše výše ladí vykreslování na jednom uzlu na vyžádání. Když jeden uzel nedokáže zatížení zvládnout, další páka není větší otočná kontrolka — jde o publikování artefaktů dokumentu jednou do sdíleného úložiště a nechat je obsluhovat všemi uzly. To mění model nákladů: vykreslování probíhá jednou na dokument místo jednou na relaci a požadavky na stránky se stávají čtením souborů. Viz Distribuovaná nasazení.

Kontrolní seznam ladění

  1. Nastavte nejnižší ImageResolution, který vaše UX akceptuje.
  2. Nechte CachePages zapnutý pro interaktivní prohlížení; vypnutý pro jednorázové nebo vysoce souběžné scénáře.
  3. Explicitně uzavírejte relace; zkracujte TimeOut tam, kde je používání burstové.
  4. Použijte LargeDoc + výchozí AutoLoad = false na klientovi pro velké dokumenty.
  5. Použijte DefaultRender = false pouze když potřebujete PDF projekci obsahující text.

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