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, oraz 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) określa zarówno czas renderowania, jak i rozmiar obrazu. Większość formatów domyślnie używa 200 DPI; obrazy i PSD domyślnie 100.

csharp
// 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. Zarezerwuj 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 domyślne ustawienie 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 buforowane strony,
  • wolisz płacić CPU za każde wyświetlenie niż zajmować RAM.
csharp
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 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, czego nie potrzebujesz. 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:
csharp
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 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 odwołania awaryjne i błędne metryki; zainstaluj czcionki lub skieruj FontFolders do folderu, w którym się znajdują.

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 — pomiń generowanie miniatur/żądania dla jednostronicowych lub osadzonych podglądów.
  • Włączenie FixedZoom zapobiega swobodnym 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 Program.cs — rejestrowanie kodowań przy każdym żądaniu to zmarnowana praca; całkowite pominięcie tego psuje starsze dokumenty o kodowaniu strony.

Rozkładanie 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 udostępnieniu ich wszystkim węzłom. Zmienia to 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

  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 explicite; skróć TimeOut tam, gdzie użycie jest burzliwe.
  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‑owej projekcji zawierającej tekst.

Czy ta strona była pomocna?