PDFium Component Docs

PageObjectSnapshotCacheCapacity eigenschap

Component: TPdf  ·  Unit: PDFium
Stelt in hoeveel volledige page-object-momentopnamen de page-object-snapshotcache voor hergebruik bewaart

Syntax

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

Description

Het lezen van PageObjectsSnapshot legt elk paginaobject vast met type, bounds, transformaties, dash-arrays, path- en clipsegmenten, content marks, image-metadata en begrensde tekst. De cache houdt één slot per documentpagina bij en bewaart voltooide momentopnamen in least-recently-used-volgorde tot deze capaciteit, zodat herhaalde objectinspectie en complexiteitsanalyse één vastlegging hergebruiken

Elke bewaarde momentopname wordt gemeten met een schatting die objectrecords, dash-arrays, path- en clipsegmenten, content marks met hun parameters, lijsten met imagefilters en tekst- en fontstrings dekt, en reserveert die schatting in de gedeelde CacheBudgetBytes-bewaker

Het verlagen van de capaciteit verwijdert de least recently used-momentopnamen en geeft hun governor-bytes onmiddellijk vrij

Remarks

Door de capaciteit op nul te zetten wordt de cache geleegd en retentie uitgeschakeld, terwijl directe begrensde reads via PageObjectsSnapshot en ReadPageObjectsSnapshot blijven werken en telkens opnieuw vastleggen

Negatieve waarden veroorzaken EPdfError

Een onvolledige vastlegging — één waarvan Status.Completed False is omdat een object-, path-, clip-, mark-, tekst- of stringbudget is geraakt — wordt aan de aanroeper teruggegeven maar nooit gecacht

Example

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

See Also

PageObjectSnapshotCacheCount, PageObjectSnapshotCacheHitCount, PageObjectsSnapshot, CacheBudgetBytes, PageObjectSnapshots