Incremental Output

The Mako SDK can be set to output incrementally, instead of performing a full serialization. This can be useful in scenarios where small updates with a fast output speed is required. In this case, the changes made to the DOM will be appended to the end of the existing PDF content.

Turning on Incremental Serialization

Enabling linearized output is straightforward, requiring a single call to your IPDFOutput class.

pdfOutput->setEnableIncrementalOutput()

pdfOutput.setEnableIncrementalOutput()

Turning on incremental output will generally improve the speed of output.

Incremental serialization requires the following to be true:

• writeAssembly() is used (rather than the IOutputWriter interface).

• The assembly has only one document

• The assembly was opened from a PDF

• The PDF was either a file or opened from a random-access stream

• The PDF version specified is the same version or higher than the input PDF

• The output is not to be linearized (See Linearized Output)

When a PDF is incrementally serialized (saved) the original content remains as a “version” of the PDF. Mako 7.3.0 introduced new methods for accessing previous versions. See Incremental save rollbackfor further details.