Dostosowanie wydajności

Profil zasobów Doconut jest zdominowany przez trzy elementy: render DPI, co pozostaje w pamięci podręcznej, i jak długo trwają sesje. Ten przewodnik omawia dźwignie w kolejności ich wpływu.

Rozdzielczość — największa dźwignia

ImageResolution (25–300 DPI) wpływa zarówno na czas renderowania, jak i rozmiar obrazu. Większość formatów domyślnie ma 200 DPI; obrazy i PSD domyślnie 100.

// Podgląd listy dokumentów nie wymaga jakości druku
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Zmniejszenie DPI o połowę przybliża się do czterokrotnego zmniejszenia liczby pikseli na stronę — szybsze renderowanie, mniejsze transfery, mniej pamięci podręcznej. Zachowaj 250–300 DPI dla przypadków intensywnego powiększania (CAD, rysunki inżynierskie).

Dla plików PDF z dużą ilością osadzonych obrazów, PdfConfig dodaje precyzyjniejsze ustawienia: CompressImages + CompressQuality, ResizeImages + ResizeResolution oraz CompressFast. Dla zwykłych obrazów, ImageConfig.MaxImagePixelSize (domyślnie 3000 px) ogranicza rozmiar wyjścia.

Buforowanie stron — pamięć vs. ponowne renderowanie

BaseConfig.CachePages (domyślnie true) przechowuje każdą wyrenderowaną stronę w pamięci przez cały czas trwania sesji. To właściwe ustawienie domyślne dla interaktywnego przeglądania — użytkownicy przewijają w przód i w tył. Wyłącz je, gdy:

• dokumenty są ogromne i przeglądane jednorazowo, od początku do końca,
• wiele jednoczesnych sesji pomnożyłoby liczbę buforowanych stron,
• wolisz płacić CPU za każde wyświetlenie niż zajmować RAM.

var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

Po stronie klienta, ViewerConfig.CacheEnabled = true wstępnie ładuje małe przesuwające się okno nadchodzących obrazów stron w pamięci przeglądarki. Jest to bufor prefetch per‑widok, a nie trwały localStorage.

Sesje — pamięć, której nie widzisz

Każda otwarta sesja przechowuje przetworzony model dokumentu plus (z CachePages) jego wyrenderowane strony, aż do upłynięcia przesuwającego się TimeOut (domyślnie 60 minut) od ostatniego żądania. Dwa nawyki utrzymują to pod kontrolą:

• Zamknij to, czego już nie potrzebujesz. viewer.CloseDocument(token) zwalnia silnik natychmiast, zamiast czekać na okno bezczynności.
• Dopasuj rozmiar limitu czasu. Podgląd, na który użytkownicy patrzą przez dwie minuty, nie wymaga godziny sesji:

var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Pamiętaj o kompromisie: po wygaśnięciu widżet pokazuje Document session not found. Please re-open document. — wybierz limit czasu, który odpowiada rzeczywistym sesjom czytania.

Przełączniki specyficzne dla formatu

• Excel: MemoryOptimizationPreference jest domyślnie włączone i zmniejsza zużycie pamięci przy renderowaniu bardzo dużych skoroszytów — pozostaw je włączone, lub ustaw na false jeśli wymienisz pamięć na niewielki przyrost szybkości; SheetNames / PrintArea ograniczają renderowanie do tego, co istotne.
• Tryb przekierowania ma koszt początkowy: DefaultRender = false konwertuje cały dokument na PDF w momencie otwarcia. Zapewnia natywne wyszukiwanie tekstowe, ale przy dokumencie 500‑stronnicowym wywołanie otwarcia niesie tę konwersję — nie włączaj go automatycznie.
• Word/PowerPoint na serwerze bez czcionek dokumentów: Windows Server bez Office ma znacznie mniej czcionek niż maszyna deweloperska. Brakujące czcionki powodują wolne próby zastępcze i nieprawidłowe metryki; zainstaluj czcionki lub wskaż FontFolders na folder, który je zawiera.

Strategie po stronie klienta

• LargeDoc = true — strategia leniwego ładowania dla bardzo dużych dokumentów; strony ładują się, gdy użytkownik się do nich zbliża.
• AutoLoad = false (domyślnie) — nie renderuj, dopóki nie wywołasz View(token).
• ShowThumbs = false — pomijaj generowanie miniatur/żądania dla podglądów jednosktronicowych lub osadzonych.
• Włączenie FixedZoom zapobiega dowolnym zmianom zoomu; gdy mapujesz C# ViewerConfig, dostosuj FixedZoomPercentMobile (domyślnie C# 75) dla małych ekranów.

Uruchamianie raz, nie przy każdym żądaniu

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) należy umieścić w Application_Start, obok DoconutHost.Initialize — rejestrowanie kodowań przy każdym żądaniu to zmarnowana praca; całkowite pominięcie tego psuje starsze dokumenty o kodowaniu stron kodowych.

Pierwszy dokument po uruchomieniu

Doconut ładuje swoje silniki dokumentów przy pierwszym otwarciu dokumentu w aplikacji — po uruchomieniu puli, po każdym recyklingu i w każdej nowej domenie aplikacji. To pierwsze otwarcie jest wolniejsze niż kolejne, a antywirus w czasie rzeczywistym może je znacznie spowolnić: silniki są ładowane z pamięci, a Microsoft Defender skanuje ten kod podczas ładowania. Wykluczenie folderu nie pomaga, ponieważ nie jest zaangażowany żaden plik.

Zmierzono na czterordzeniowym serwerze Windows Server 2022, otwierając dwustronicowy dokument Word:

Zapłać raz, zanim zrobią to Twoi użytkownicy:

• Utrzymuj proces roboczy aktywny: ustaw Start Mode puli aplikacji na AlwaysRunning i podnieś lub wyłącz idle time-out, aby nocna cisza nie wyładowała silników.
• Rozgrzej go przy starcie: włącz Application Initialization IIS (preloadEnabled="true" na stronie) i wskaż jego initializationPage na swoją stronę, która otwiera mały dokument. Pierwszy prawdziwy użytkownik znajdzie wtedy silniki już załadowane.
• Daj pierwszemu żądaniu czas: kontrola stanu load balancera lub proxy upstream z krótkim limitem czasu może zrezygnować z zimnego startu, który by się powiódł.

Decyzja o zmianie ustawień antywirusa na serwerze należy do zespołu ds. bezpieczeństwa; powyższe rozgrzewanie działa bez niego.

Pula aplikacji

Na pojedynczym serwerze sesje dokumentów i buforowane strony znajdują się w procesie roboczym. Każdy recykling puli aplikacji — zaplanowany, edycja Web.config lub idle time-out puli (domyślnie 20 minut w IIS) — usuwa je wszystkie, a otwarte przeglądarki wtedy pokazują Document session not found. Please re-open document.

• Dostosuj idle time-out puli i harmonogram recyklingu do tego, jak długo użytkownicy faktycznie czytają, lub bądź gotów ponownie otworzyć dokumenty po recyklingu.
• Uruchamiaj pulę jako proces 64‑bitowy (pozostaw Enable 32-Bit Applications wyłączone). Duże dokumenty potrzebują przestrzeni adresowej, której proces 32‑bitowy nie ma.
• Farma sieciowa przechowuje sesje w wspólnym magazynie, więc recykling jednego węzła nie powoduje ich utraty — zobacz Sesje i bezpieczeństwo.

Lista kontrolna dostrajania

1. Ustaw najniższy ImageResolution, jaki akceptuje Twoje UX.
2. Pozostaw CachePages włączone dla interaktywnego przeglądania; wyłączone w scenariuszach jednorazowego przeglądu lub wysokiej współbieżności.
3. Zamykaj sesje jawnie; skróć TimeOut tam, gdzie użycie jest przerywane.
4. Użyj LargeDoc + domyślnego AutoLoad = false po stronie klienta dla dużych dokumentów.
5. Użyj DefaultRender = false tylko wtedy, gdy potrzebujesz PDF z tekstem.