PDFium Delphi Component Docs

คุณสมบัติ StructureCacheHitCount

Component: TPdf  ·  Unit: PDFium
นับจำนวนครั้งที่อ่าน structure element แล้วให้บริการจาก structure tree ของหน้าที่เก็บไว้

Syntax

property StructureCacheHitCount: Int64; // read only

Description

ตัวนับเพิ่มขึ้นหนึ่งทุกครั้งที่เข้าถึง StructureElementsForPage หรือ StructureElements แล้วหน้านั้นมี tree ใน cache ที่ valid อยู่แล้ว hit จะทำให้ slot ของหน้ากลับมาเป็นตัวล่าสุดในลำดับ least-recently-use จับต้อง entry ใน cache governor ที่ใช้ร่วมกัน แล้วคืน deep clone ของ snapshot ที่เก็บไว้

ค่านี้สะสมตลอดอายุของ instance TPdf และไม่เคยรีเซ็ต อัตรา hit ที่เพิ่มขึ้นจึงบอกว่าการตรวจ accessibility และการเดินโครงสร้างซ้ำ ๆ ใช้ผล parse เพียงชุดเดียวร่วมกัน

Remarks

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

การเปลี่ยน capacity การแก้หน้า การโหลดเอกสารใหม่ และการล้าง cache ไม่กระทบตัวนับ สิ่งเหล่านี้เปลี่ยนแค่สิ่งที่ถูกเก็บไว้ ไม่ใช่สิ่งที่เกิดขึ้นไปแล้ว

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

Example

for I := 1 to PageCount do
  AuditStructure(Pdf.StructureElementsForPage[I]);
Ratio := Pdf.StructureCacheHitCount /
  (Pdf.StructureCacheHitCount + Pdf.StructureCacheMissCount);

See Also

StructureCacheMissCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage