PDFium Delphi Component Docs

ThumbnailCacheStatistics властивість

Component: TPdf  ·  Unit: PDFium
Повертає телеметрію записів, байтів, влучань, промахів і витіснень для кешу мініатюр з урахуванням редакцій

Syntax

property ThumbnailCacheStatistics: TPdfThumbnailCacheStatistics; // read only

 

type TPdfThumbnailCacheStatistics = record
  EntryCount: Integer;
  StoredBytes: Int64;
  HitCount: Int64;
  MissCount: Int64;
  EvictionCount: Int64;
end;

EntryCountУтримувані записи: рахує і записи бітових карт, і кешовану відсутність необов'язкових вбудованих мініатюр.
StoredBytesОцінена пам'ять бітової карти як ширина × висота × чотири байти; негативні записи нульового розміру нічого не додають.
HitCountСумарні пошуки, обслужені з утримуваного запису.
MissCountСумарні пошуки, для яких довелося видобувати чи рендерити, включно з кожним пошуком, зробленим поки утримання вимкнено.
EvictionCountСумарна кількість записів, відкинутих через тиск найменш нещодавно використаних або зменшення стелі.

Description

Повторні виклики ExtractThumbnail і RenderPageThumbnail дають влучання й промахи під тим самим блокуванням рендерингу, який використовується рідним доступом до сторінок PDFium, тож лічильники рухаються лише через задокументовані шляхи пошуку

Кожен успішний пошук бітової карти повертає глибоку копію у власності викликача, тож звільнення чи модифікація повернутої бітової карти не може вплинути на пізніше влучання, а кешований запис тримає свої виміряні байти, доки його не витіснено чи не інвалідовано

Лічильники накопичуються протягом усього життя екземпляра TPdf. ClearThumbnailCache і внутрішні шляхи інвалідації зберігають їх

Remarks

Витіснення рахується, коли тиск стелі відкидає утримуваний запис, зокрема коли керуючий витісняє мініатюри заради CacheBudgetBytes; відкидання записів через редагування їхньої сторінки — це інвалідація і не збільшує EvictionCount

Читання повертає нульований запис, коли кеш недоступний, що на практиці трапляється лише поза нормальним життєвим циклом компонента

Example

Stats := Pdf.ThumbnailCacheStatistics;
LogThumbnailCache(Stats.EntryCount, Stats.HitCount, Stats.MissCount,
  Stats.EvictionCount);

See Also

ThumbnailCacheMaxEntries, ThumbnailCacheMaxBytes, ClearThumbnailCache, CacheGovernorStatistics, Thumbnail cache