THPDFIncrementalXRefRebuildInfo Record
Telemetry of the free-object table rebuilt during the last incremental save: source, newly freed, and rebuilt entry counts, generation increments and saturation, first free object number, and highest generation
Declaration
THPDFIncrementalXRefRebuildInfo= record
SourceFreeObjectCount: Integer;
NewlyFreedObjectCount: Integer;
RebuiltFreeObjectCount: Integer;
GenerationIncrementCount: Integer;
SaturatedGenerationCount: Integer;
FirstFreeObjectNumber: Integer;
HighestGenerationNumber: Integer;
Rebuilt: boolean;
end;Unit
HPDFDoc
Fields
| Field | Purpose |
|---|---|
SourceFreeObjectCount | Free entries inherited from the source revision when the incremental update began |
NewlyFreedObjectCount | Objects freed while preparing this incremental update |
RebuiltFreeObjectCount | Free entries written into the rebuilt cross-reference table |
GenerationIncrementCount | Freed objects whose generation number was bumped for the new revision |
SaturatedGenerationCount | Freed objects already at the maximum generation that cannot be incremented further |
FirstFreeObjectNumber | Head of the rebuilt free-entry linked list (the traditional first-section f entry) |
HighestGenerationNumber | Highest generation number observed while rebuilding |
Rebuilt | true when the save actually rebuilt the free table; also the result of the accessor |
Usage notes
- Read it back with
THotPDF.GetLastIncrementalXRefRebuildInfoafterSaveIncrementalUpdate; the record reflects only the most recent save - A
Rebuiltvalue offalsemeans the accessor reports stale or empty data because no rebuild happened yet - Use
SaturatedGenerationCountto spot documents recycled so often that freed object numbers can no longer bump their generation