THotPDF.SaveIncrementalUpdate

THotPDF

Writes the original PDF bytes followed by the dirty objects, a new xref subsection, and a trailer with a /Prev pointer.

Delphi syntax:

procedure SaveIncrementalUpdate(const TargetFile: TFileName);

C++ syntax:

void __fastcall SaveIncrementalUpdate(System::Sysutils::TFileName TargetFile);

Description

SaveIncrementalUpdate completes the workflow started by BeginIncrementalUpdate. The source bytes are copied verbatim, so existing byte ranges and earlier signatures remain intact. Only dirty objects are appended to the end of the target file

When no object is dirty, the target is byte-identical to the source and no xref section, trailer, newline, or EOF marker is appended. When a revision is required, the first trailer ID remains stable and only the second modification ID is rotated

Call this method before preparing or inserting a new signature when adding a later signature revision. After the appended file exists, use the normal signing helpers to reserve and fill the new signature value

See also: BeginIncrementalUpdate, MarkDirty, AcroForm Support, PDF Filter Support