Ladění výkonu
Optimalizace vykreslování a paměti
Profil zdrojů Doconutu je ovládán třemi věcmi: render DPI, co zůstává v keši, a jak dlouho relace žijí. Tento průvodce prochází páky v pořadí 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.
// 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 v keši. Vyhraďte 250–300 DPI pro případy s intenzivním přiblížením (CAD, technické výkresy).
Pro PDF s těžkou vloženou grafikou 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. 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 to, 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 platíte CPU za zobrazení než držíte RAM.
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čítání 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 to, 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ý uživatelé mrknou dva minuty, nepotřebuje hodinovou relaci:
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:
MemoryOptimizationPreferenceje 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 nafalse, pokud chcete vyměnit paměť za malý nárůst rychlosti;SheetNames/PrintAreaomezují vykreslování na to, co je podstatné. - Režim přesměrování má předběžný náklad:
DefaultRender = falsepřevádí celý dokument do PDF při otevření. Zajišťuje nativní textové vyhledávání, ale u 500stránkového dokumentu otevření nese tuto konverzi — neaktivujte jej reflexivně. - Word/PPT na Linuxu/Dockeru: chybějící fonty způsobují pomalé zkoušení náhrad a špatné metriky; nasměrujte
FontFoldersna adresář s vašimi fonty. - Prezentace na Linuxu: není potřeba žádný přepínač
libgdiplusaniSystem.Drawing.EnableUnixSupport— viz Písma na Linuxu.
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áteView(token).ShowThumbs = false— přeskočte generování náhledových miniatur/požadavky pro jednostránkové nebo vložené náhledy.- Povolení
FixedZoomzabraňuje volným změnám přiblížení; když mapujete C#ViewerConfig, nastavteFixedZoomPercentMobile(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 dokumenty se starými kódovými stránkami.
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í absorbovat, další páka není větší otočka — jde o publikování artefaktů dokumentu jednou do sdíleného úložiště a nechat je obsluhovat každým uzlem. 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í
- Nastavte nejnižší
ImageResolution, který vaše UX akceptuje. - Nechte
CachePageszapnutý pro interaktivní prohlížení; vypnutý pro jednorázové nebo scénáře s vysokou souběžností. - Explicitně ukončujte relace; zkracujte
TimeOuttam, kde je používání burstové. - Použijte
LargeDoc+ výchozíAutoLoad = falsena klientovi pro velké dokumenty. - Používejte
DefaultRender = falsejen když potřebujete PDF projekci s textem.
Byla tato stránka užitečná?