PDFium Delphi Component Docs

StructureCacheHitCount Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Zählt Structure-Element-Lesezugriffe, die aus einem vorgehaltenen Seitenstruktur baum bedient wurden

Syntax

property StructureCacheHitCount: Int64; // read only

Beschreibung

Der Zähler erhöht sich einmal für jeden StructureElementsForPage- oder StructureElements-Zugriff, dessen Seite bereits einen gültigen zwischengespeicherten Baum hält. Der Treffer aktualisiert den Seitenslot in der Least-Recently-Used-Reihenfolge, berührt den Eintrag im gemeinsamen Cache-Governor und liefert einen Deep Clone des vorgehaltenen Snapshots

Der Wert ist kumulativ über die Lebensdauer der TPdf-Instanz und wird nie zurückgesetzt, sodass eine steigende Trefferquote zeigt, dass wiederholte Barrierefreiheitsvalidierung und Strukturtraversierung ein einziges Parsen wiederverwenden

Hinweise

Das Lesen wird durch den Render-Lock geschützt, den auch der native PDFium-Seitenzugriff verwendet

Kapazitätsänderungen, Seitenbearbeitungen, Dokument-Neuladen und Löschvorgänge erhalten den Zähler; sie ändern, was vorgehalten wird, nicht was bereits geschehen ist

Kombinieren Sie den Wert mit StructureCacheMissCount, um die effektive Trefferquote zu berechnen

Beispiel

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

Siehe auch

StructureCacheMissCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage