PDFiumPas 文件

PageObjectSnapshotCacheCapacity 屬性

元件: TPdf  ·  單元: PDFium
設定頁面物件快照快取要保留多少份完整的頁面物件快照供重用

Syntax

property PageObjectSnapshotCacheCapacity: Integer; // read and write, default 8

Description

讀取 PageObjectsSnapshot 會擷取每個頁面物件及其型別、邊界、變換矩陣、虛線陣列、路徑與裁剪線段、內容標記、影像中繼資料與有界文字。快取為文件的每一頁保留一個槽位,並以這個容量為上限、依最近最少使用順序保留完成的快照,讓重複的物件檢視與複雜度分析能重用同一次擷取

每份保留的快照都以估算值量測,涵蓋物件記錄、虛線陣列、路徑與裁剪線段、內容標記及其參數、影像濾鏡清單,以及文字與字型字串,並在共用的 CacheBudgetBytes 管控器中保留該估算額度

調降容量會逐出最近最少使用的快照,並立即釋放其在管控器中佔用的位元組

Remarks

把容量設為 0 會清空快取並停用保留,而透過 PageObjectsSnapshotReadPageObjectsSnapshot 的直接有界讀取仍可運作,只是每次都重新擷取

負值會引發 EPdfError

不完整的擷取(因為觸及物件、路徑、裁剪、標記、文字或字串額度而使 Status.CompletedFalse)仍會傳回給呼叫端,但不會被快取

Example

Pdf.PageObjectSnapshotCacheCapacity := 16;
Snapshot := Pdf.PageObjectsSnapshot[PageNumber];
LogObjectKinds(Snapshot.Objects);

See Also

PageObjectSnapshotCacheCount, PageObjectSnapshotCacheHitCount, PageObjectsSnapshot, CacheBudgetBytes, PageObjectSnapshots