Dostosowywanie wydajności
Optymalizacja renderowania i pamię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 mają 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ę mniej więcej zmniejsza liczbę pikseli na stronę do jednej czwartej — 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 drobniejsze ustawienia: CompressImages + CompressQuality, ResizeImages + ResizeResolution oraz CompressFast. Dla zwykłych obrazów, ImageConfig.MaxImagePixelSize (domyślnie 3000 px) ogranicza rozmiar wyjściowy.
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 równoczesnych sesji pomnożyłoby liczbę buforowanych stron,
- wolisz zużywać CPU na każde wyświetlenie niż zajmować pamięć RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });Po stronie klienta, ViewerConfig.CacheEnabled = true wczytuje wstępnie 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 oraz (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, z czego skończyłeś.
viewer.CloseDocument(token)zwalnia silnik natychmiast, zamiast czekać na okno bezczynności. - Dostosuj czas wygaśnięcia. 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 widget wyświetla Document session not found. Please re-open document. — wybierz czas wygaśnięcia, który odpowiada rzeczywistym sesjom czytania.
Przełączniki specyficzne dla formatów
- Excel:
MemoryOptimizationPreferencejest domyślnie włączony i zmniejsza zużycie pamięci przy renderowaniu bardzo dużych skoroszytów — pozostaw go włączony, lub ustaw nafalsejeśli chcesz wymienić pamięć na niewielki przyrost prędkości;SheetNames/PrintAreaograniczają renderowanie do tego, co istotne. - Tryb przekierowania ma koszt początkowy:
DefaultRender = falsekonwertuje 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 odruchowo. - Word/PPT na Linux/Docker: brakujące czcionki powodują wolne sondowanie awaryjne i błędne metryki; skieruj
FontFoldersdo katalogu z twoimi czcionkami. - Prezentacje na Linux: nie jest potrzebny przełącznik
libgdiplusaniSystem.Drawing.EnableUnixSupport— zobacz Czcionki w Linuxie.
Strategie po stronie klienta
LargeDoc = true— strategia leniwego ładowania dla bardzo dużych dokumentów; strony ładują się w miarę zbliżania się użytkownika.AutoLoad = false(domyślnie) — nie renderuj, dopóki nie wywołaszView(token).ShowThumbs = false— pomijaj generowanie miniatur/żądania dla jednosktronicowych lub osadzonych podglądów.- Włączenie
FixedZoomzapobiega swobodnym zmianom zoomu; gdy mapujesz C#ViewerConfig, dostosujFixedZoomPercentMobile(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 Program.cs — rejestrowanie kodowań przy każdym żądaniu to zmarnowana praca; całkowite pominięcie tego psuje starsze dokumenty o kodowaniu stron kodowych.
Rozpraszanie pracy na węzły
Wszystko powyżej dostraja renderowanie jednego węzła na żądanie.
Gdy pojedynczy węzeł nie może przyjąć obciążenia,
kolejna dźwignia nie jest większym pokrętłem — polega na opublikowaniu artefaktów dokumentu raz w wspólnym magazynie i pozwoleniu każdemu węzłowi na ich serwowanie.
To zmienia model kosztów:
renderowanie odbywa się raz na dokument zamiast raz na sesję, a żądania stron stają się odczytami plików. Zobacz Rozproszone wdrożenia.
Lista kontrolna dostrajania
- Ustaw najniższy
ImageResolution, jaki akceptuje twoje UX. - Pozostaw
CachePageswłączony dla interaktywnego przeglądania; wyłączony w scenariuszach jednorazowego przetwarzania lub wysokiej współbieżności. - Zamykaj sesje explicite; skróć
TimeOuttam, gdzie użycie jest burzliwe. - Użyj
LargeDoc+ domyślnegoAutoLoad = falsepo stronie klienta dla dużych dokumentów. - Używaj
DefaultRender = falsetylko wtedy, gdy potrzebujesz projekcji PDF zawierającej tekst.
Czy ta strona była pomocna?