THotPDF.BeginIncrementalUpdate

THotPDF

Loads an existing PDF and switches the document into append-only incremental update mode.

Delphi syntax:

procedure BeginIncrementalUpdate(const SourceFile: TFileName);

C++ syntax:

void __fastcall BeginIncrementalUpdate(System::Sysutils::TFileName SourceFile);

Description

Call BeginIncrementalUpdate when an existing PDF must be extended without rewriting its original bytes. HotPDF parses the source file through the normal load path and keeps a byte-for-byte copy of the original file for the later save step.

New indirect objects created after this call are marked dirty automatically. Existing loaded objects are only re-emitted when the caller marks them with MarkDirty.

This workflow is useful for adding a later signature field, appending metadata, or extending an already signed document while preserving the byte ranges covered by earlier digital signatures.

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