PDFium Delphi Component Docs

คุณสมบัติ ThumbnailCacheMaxEntries

Component: TPdf  ·  Unit: PDFium
กำหนดว่า thumbnail cache ที่รู้เรื่อง revision จะเก็บ preview ไว้ได้พร้อมกันสูงสุดกี่รายการ

Syntax

property ThumbnailCacheMaxEntries: Integer; // read and write, default 64

Description

cache เก็บทั้ง preview แบบ embedded ที่ได้จาก ExtractThumbnail และ preview ที่เรนเดอร์ได้จาก RenderPageThumbnail ไว้ใต้นโยบาย least-recently-used นโยบายเดียว ส่วนคุณสมบัตินี้จำกัดว่า entry จะรอดอยู่ได้กี่รายการ โดยนับรวมทั้ง entry bitmap และ entry เชิงลบที่แคชไว้จดจำว่าหน้าไม่มี /Thumb แบบ embedded

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

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

Remarks

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

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

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

Example

Pdf.ThumbnailCacheMaxEntries := 128;
Pdf.ThumbnailCacheMaxBytes := Int64(96) * 1024 * 1024;

See Also

ThumbnailCacheMaxBytes, ThumbnailCacheStatistics, ClearThumbnailCache, Thumbnail cache