THotPDF.GetLastIncrementalXRefRebuildInfo

Returns statistics for the free-object chain rebuilt by the most recent SaveIncrementalUpdate call

Declaration

function GetLastIncrementalXRefRebuildInfo(
  out Info: THPDFIncrementalXRefRebuildInfo
): boolean;

The result is true after an incremental revision was written and false before a rebuild or after a byte-identical no-op save

Fields

• SourceFreeObjectCount counts active free entries inherited from the source revision chain
• NewlyFreedObjectCount counts in-use objects transitioned to free by this revision
• RebuiltFreeObjectCount is the complete emitted free set excluding object 0
• GenerationIncrementCount and SaturatedGenerationCount separate successful generation advances from entries already at 65535
• FirstFreeObjectNumber identifies the object referenced by the object-zero chain head
• HighestGenerationNumber reports the greatest generation in the rebuilt free set
• Rebuilt confirms that the appended xref revision completed

Behaviour

The writer merges existing free entries, newly deleted indirect objects and automatically removed orphan encryption dictionaries, then emits one ascending deterministic chain. Existing free generations remain unchanged, newly freed generations advance with 65535 saturation, and rewritten live objects retain the generation used by their indirect-object headers