PDFium Delphi Component Docs

StructureCacheMissCount プロパティ

コンポーネント: TPdf  ·  ユニット: PDFium
ページ構造ツリーの解析が必要だった、構造要素読み取りの回数を数えます

構文

property StructureCacheMissCount: Int64; // read only

説明

このカウンターは、ページスロットが有効でない StructureElementsForPage または StructureElements へのアクセス 1 回ごとに 1 ずつ増加します。これは、最初のアクセス時、容量の圧力によってエントリーが退避された後、ページが編集された後、ドキュメントの再読み込みによってスロット配列のサイズが変更された後に起こります

ミスは TPdfStructureReadOptions.Default による新しい走査を引き起こします。結果が保存されるのは容量が正で走査が完了した場合のみで、それ以外の場合は次のアクセスで解析が繰り返されます

この値は TPdf インスタンスの生存期間中累積し、リセットされることはありません

備考

読み取りはネイティブ PDFium ページアクセスが使用するレンダーロックによって保護されています

ルックアップが拒否されることはありません。保持が無効な場合、すべてのアクセスはミスになりますが、それでも新たに解析された要素が返されます

実効ミス率を計算するには、この値を StructureCacheHitCount と組み合わせてください

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

関連項目

StructureCacheHitCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage