PDFium Delphi Component Docs

ThumbnailCacheStatistics ویژگی

کامپوننت: TPdf  ·  واحد: PDFium
تلمتری ورودی، بایت، hit، miss و اخراج کش تصاویر بندانگشتی حساس به بازنگری را برمی‌گرداند

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ورودی‌های تجمعی رهاشده به‌سبب فشار کم‌استفاده‌ترین (LRU) یا کوچک‌شدن سقف

Description

فراخوانی‌های مکرر ExtractThumbnail و RenderPageThumbnail زیر همان قفل رندری که دسترسی نیتیو به صفحهٔ PDFium به کار می‌برد hit و miss تولید می‌کنند، پس شمارنده‌ها فقط از مسیرهای جست‌وجوی مستندشده جابه‌جا می‌شوند

هر جست‌وجوی موفق بیت‌مپ یک کپی عمیق متعلق به فراخوان برمی‌گرداند، بنابراین آزادکردن یا تغییر یک بیت‌مپ بازگردانده‌شده نمی‌تواند بر یک hit بعدی اثر بگذارد و ورودی کش‌شده بایت‌های اندازه‌گیری‌شده‌اش را تا اخراج یا ابطال حفظ می‌کند

شمارنده‌ها در طول عمر نمونهٔ 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