PDFium Delphi Component Docs

คุณสมบัติ ThumbnailCacheMaxBytes

Component: TPdf  ·  Unit: PDFium
กำหนดเพดานไบต์ของ thumbnail cache ที่รู้เรื่อง revision

Syntax

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

Description

thumbnail ที่เก็บไว้แต่ละรายการถูกวัดด้วยสูตรกว้าง x สูง x สี่ไบต์ของ bitmap โดย StoredBytes ใน ThumbnailCacheStatistics รายงานผลรวม ส่วน entry เชิงลบที่เก็บไว้ คือการจดจำว่าหน้าไม่มี /Thumb แบบ embedded จะถูกวัดเป็นศูนย์ไบต์

การเก็บซ้ำต้องให้เพดานนี้และ ThumbnailCacheMaxEntries เป็นบวกทั้งคู่ และ entry จะถูกเก็บก็ต่อเมื่อเพดานทั้งสองยังรองรับ bitmap เดี่ยว ๆ ที่ใหญ่กว่าเพดานนี้เพียงลำพังจะไม่ถูกเก็บเลย

การลดค่าจะไล่ entry ที่ไม่ได้ใช้นานสุดออกทันที และ entry ที่ถูกทิ้งแต่ละรายการจะเพิ่ม EvictionCount ใน ThumbnailCacheStatistics

Remarks

ตั้งเพดานเป็นศูนย์จะปิดการเก็บซ้ำ แต่การดึงและการเรนเดอร์ยังใช้ได้เต็มรูปแบบ โดยทุกการ lookup จะถูกนับเป็น miss

ค่าติดลบทำให้เกิด EPdfError

entry ที่เก็บไว้ยังจองไบต์ที่วัดได้ไว้ใน governor CacheBudgetBytes ที่ใช้ร่วมกันด้วย เพดานนี้จึงจำกัดเฉพาะ thumbnail cache ส่วน governor จำกัดทั้ง instance

คุณสมบัตินี้ถูกปกป้องด้วย render lock เดียวกับที่ใช้เข้าถึงหน้าของ PDFium ระดับ native การเปลี่ยนค่าจึงต้องรอการเรนเดอร์ที่กำลังค้างอยู่ชั่วครู่

Example

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

See Also

ThumbnailCacheMaxEntries, ThumbnailCacheStatistics, CacheBudgetBytes, ClearThumbnailCache, Thumbnail cache