PDFium Delphi Component Docs

ThumbnailCacheStatistics Egenskap

Component: TPdf  ·  Unit: PDFium
Returnerar telemetri om poster, bytes, träffar, missar och utkastade poster för den revisionsmedvetna miniatyrbildscachen

Syntax

property ThumbnailCacheStatistics: TPdfThumbnailCacheStatistics; // read only

 

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

EntryCountKvarhållna poster, räknat som positiva bitmappsposter plus cachad frånvaro av valfria inbäddade miniatyrbilder
StoredBytesUppskattat bitmappsminne som bredd gånger höjd gånger fyra bytes; negativa poster på noll byte lägger inget
HitCountKumulativa uppslagningar som besvarats från en kvarhållen post
MissCountKumulativa uppslagningar som var tvungna att extrahera eller rendera, inklusive varje uppslagning som görs medan retention är avstängd
EvictionCountKumulativa poster som kastats ut på grund av least-recently-used-tryck eller sänkta tak

Description

Upprepade ExtractThumbnail- och RenderPageThumbnail-anrop ger träffar och missar under samma renderingslås som nativ PDFium-sidåtkomst använder, så räknarna rör sig bara via de dokumenterade uppslagsvägarna

Varje lyckad bitmappsuppslagning returnerar en djup kopia som ägs av anroparen, så att frigöra eller ändra en returnerad bitmapp inte kan påverka en senare träff, och den cachade posten behåller sina uppmätta bytes tills den kastas ut eller ogiltigförklaras

Räknarna är kumulativa under TPdf-instansens livstid. ClearThumbnailCache och de interna ogiltigförklaringsvägarna bevarar dem

Remarks

En utkastning räknas när taktryck kastar ut en kvarhållen post, inklusive när governorn kastar ut miniatyrbilder för att hedra CacheBudgetBytes; poster som släpps för att deras sida redigerats är ogiltigförklaring och ökar inte EvictionCount

Uppslagningen returnerar en nollställd post när cachen inte är tillgänglig, vilket i praktiken bara händer utanför komponentens normala livstid

Example

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

See Also

ThumbnailCacheMaxEntries, ThumbnailCacheMaxBytes, ClearThumbnailCache, CacheGovernorStatistics, Miniatyrbildscache