PDFium Delphi Component Docs

ThumbnailCacheMaxBytes Свойство

Компонент: TPdf  ·  Модуль: PDFium
Задаёт потолок в байтах для зависящего от редакции кэша миниатюр

Syntax

property ThumbnailCacheMaxBytes: Int64; // read and write, default 64 MiB

Description

Каждая удерживаемая миниатюра измеряется как ширина её битовой карты, умноженная на высоту и на четыре байта, а StoredBytes в ThumbnailCacheStatistics сообщает сумму. Кэшированные отрицательные записи — запомненное отсутствие встроенного /Thumb — измеряются нулём байтов

Для удержания нужны положительные значения и этого потолка, и ThumbnailCacheMaxEntries; запись сохраняется, только пока её допускают оба потолка. Одиночная битовая карта крупнее этого потолка сама по себе никогда не удерживается

Уменьшение значения немедленно вытесняет наименее недавно использовавшиеся записи, и каждая сброшенная запись увеличивает EvictionCount в ThumbnailCacheStatistics

Remarks

Нулевой потолок отключает удержание, полностью сохраняя доступность извлечения и отрисовки; каждое обращение тогда считается промахом

Отрицательные значения возбуждают EPdfError

Удерживаемые записи также резервируют свои измеренные байты в общем регуляторе CacheBudgetBytes, так что этот потолок ограничивает именно кэш миниатюр, а регулятор — экземпляр в целом

Свойство защищено блокировкой отрисовки, которой пользуется нативный доступ к страницам PDFium, поэтому его изменение ненадолго ждёт выполняющейся отрисовки

Example

Pdf.ThumbnailCacheMaxBytes := Int64(96) * 1024 * 1024;
Stats := Pdf.ThumbnailCacheStatistics;
LogThumbnailBytes(Stats.StoredBytes);

See Also

ThumbnailCacheMaxEntries, ThumbnailCacheStatistics, CacheBudgetBytes, ClearThumbnailCache, Кэш миниатюр