PDFium Delphi Component Docs

คุณสมบัติ StructureCacheMissCount

Component: TPdf  ·  Unit: PDFium
นับจำนวนครั้งที่อ่าน structure element แล้วต้อง parse structure tree ของหน้าใหม่

Syntax

property StructureCacheMissCount: Int64; // read only

Description

ตัวนับเพิ่มขึ้นหนึ่งทุกครั้งที่เข้าถึง StructureElementsForPage หรือ StructureElements แล้ว slot ของหน้านั้นยังไม่ valid เกิดได้ทั้งตอนเข้าถึงครั้งแรก หลัง entry ถูกไล่ออกเพราะแรงกดดันด้าน capacity หลังหน้าถูกแก้ไข และหลังการโหลดเอกสารใหม่จัดขนาดอาร์เรย์ slot ใหม่

miss จะทำให้เดิน traversal ใหม่ด้วย TPdfStructureReadOptions.Default ผลลัพธ์จะถูกเก็บก็ต่อเมื่อ capacity เป็นบวกและ traversal สำเร็จครบ มิฉะนั้นการ parse จะเกิดซ้ำในการเข้าถึงครั้งถัดไป

ค่านี้สะสมตลอดอายุของ instance TPdf และไม่เคยรีเซ็ต

Remarks

การอ่านถูกปกป้องด้วย render lock เดียวกับที่ใช้เข้าถึงหน้าของ PDFium ระดับ native

lookup ไม่เคยถูกปฏิเสธ เมื่อปิดการเก็บซ้ำ ทุกการเข้าถึงจะเป็น miss แต่ยังคืน element ที่ parse สดใหม่ให้เสมอ

ใช้ค่านี้คู่กับ StructureCacheHitCount เพื่อคำนวณ miss ratio ที่มีผลจริง

Example

Pdf.StructureCacheCapacity := 0;
Elements := Pdf.StructureElementsForPage[1];
Elements := Pdf.StructureElementsForPage[1];
// StructureCacheMissCount advanced twice, HitCount stayed unchanged

See Also

StructureCacheHitCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage