Тонкая настройка производительности

Оптимизация рендеринга и памяти

Ресурсный профиль Doconut определяется тремя вещами: разрешение рендеринга DPI, что кэшируется, и как долго живут сессии. Это руководство рассматривает рычаги в порядке их влияния.

Разрешение — самый мощный рычаг

ImageResolution (25–300 DPI) определяет как время рендеринга, так и размер изображения. Большинство форматов по умолчанию используют 200 DPI; изображения и PSD — 100.

csharp
// Для предварительного просмотра списка документов не требуется качество печати
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Уменьшение DPI вдвое примерно уменьшает количество пикселей на странице вчетверо — рендеринг становится быстрее, передача данных меньше, требуется меньше памяти кэша. Оставляйте 250–300 DPI для сценариев с интенсивным масштабированием (CAD, инженерные чертежи).

Для PDF с большим количеством встроенных изображений, PdfConfig добавляет более тонкие настройки: CompressImages + CompressQuality, ResizeImages + ResizeResolution и CompressFast. Для обычных изображений, ImageConfig.MaxImagePixelSize (по умолчанию 3000 px) ограничивает размер вывода.

Кеширование страниц — память vs. повторный рендер

BaseConfig.CachePages (по умолчанию true) сохраняет каждую отрисованную страницу в памяти на протяжении всей сессии. Это правильный параметр по умолчанию для интерактивного просмотра — пользователи прокручивают назад и вперёд. Отключайте его, когда:

  • документы огромные и просматриваются один раз, от начала до конца,
  • множество одновременных сессий умножит количество кешированных страниц,
  • вы предпочли бы платить за процессор за каждый просмотр, а не держать ОЗУ.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

На клиенте ViewerConfig.CacheEnabled = true предварительно загружает небольшое скользящее окно будущих изображений страниц в памяти браузера. Это кеш предзагрузки для конкретного просмотра, а не постоянный localStorage.

Сессии — память, которую вы не видите

Каждая открытая сессия хранит разобранную модель документа плюс (с CachePages) её отрисованные страницы, пока не истечёт скользящее окно TimeOut (по умолчанию 60 минут), с момента последнего запроса. Две привычки держат это под контролем:

  • Закрывайте то, чем закончили пользоваться. viewer.CloseDocument(token) освобождает движок немедленно, вместо ожидания простоя.
  • Подбирайте оптимальное время ожидания. Предпросмотр, который пользователи просматривают две минуты, не требует часовой сессии:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Помните о компромиссе: после истечения срока виджет показывает Document session not found. Please re-open document. — выберите тайм‑аут, соответствующий реальным сессиям чтения.

Формат‑специфичные переключатели

  • Excel: MemoryOptimizationPreference включён по умолчанию и уменьшает объём памяти при рендеринге очень больших книг — оставьте его включённым, или установите значение false, если хотите обменять память на небольшое ускорение; SheetNames / PrintArea ограничивают рендеринг тем, что имеет значение.
  • Режим перенаправления имеет начальные затраты: DefaultRender = false преобразует весь документ в PDF при открытии. Это обеспечивает нативный поиск по тексту, но для 500‑страничного документа вызов открытия включает эту конверсию — не включайте его автоматически.
  • Word/PPT на Linux/Docker: отсутствие шрифтов вызывает медленное резервное пробирование и неверные метрики; укажите FontFolders на каталог с вашими шрифтами.
  • Презентации на Linux: переключатели libgdiplus или System.Drawing.EnableUnixSupport не требуются — см. Fonts on Linux.

Стратегии на стороне клиента

  • LargeDoc = true — стратегия ленивой загрузки для очень больших документов; страницы загружаются по мере приближения пользователя.
  • AutoLoad = false (по умолчанию) — не выполнять рендеринг, пока вы действительно не вызовете View(token).
  • ShowThumbs = false — пропускать генерацию и запросы миниатюр для одностраничных или встроенных превью.
  • Включение FixedZoom предотвращает произвольные изменения масштаба; когда вы сопоставляете C# ViewerConfig, настройте FixedZoomPercentMobile (по умолчанию C# 75) для небольших экранов.

Инициализация один раз, а не при каждом запросе

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) принадлежит Program.cs — регистрация кодировок при каждом запросе является лишней работой; полное её отсутствие ломает документы со старой кодовой страницей.

Распределение нагрузки между узлами

Все вышеупомянутое настраивает рендеринг на одном узле по запросу. Когда один узел не может справиться с нагрузкой, следующий рычаг не является большим переключателем — это публикация артефактов документа один раз в совместное хранилище и предоставление их каждому узлу. Это меняет модель затрат: рендеринг происходит один раз на документ вместо одного раза на сессию, а запросы страниц становятся чтением файлов. См. Распределённые развертывания.

Чек‑лист настройки

  1. Установите самое низкое значение ImageResolution, которое принимает ваш UX.
  2. Оставляйте CachePages включённым для интерактивного просмотра; отключайте в сценариях однопроходного или высокой конкуренции.
  3. Явно закрывайте сессии; сокращайте TimeOut там, где использование скачкообразно.
  4. Используйте LargeDoc + значение по умолчанию AutoLoad = false на клиенте для больших документов.
  5. Применяйте DefaultRender = false только когда требуется PDF‑проекция с текстом.

Была ли эта страница полезной?