SaveFlags

Values

Incremental

Incremental save only write objects that have changed after the end of the document rather than disturbing unchanged items. Use with Copy to create a new file which incorporates a copy of the input file before making changes. This flag can be useful when making changes to signed documents, as it preserves the validity of any existing signatures.

Full

Save the entire document.

Copy

Saves a copy of the document. Used with Incremental to create a new file from a binary copy of the input document.

Linearized

Save in a format that is suitable for remote (network) access, Linearized is sometimes referred to as Web Optimized because of its goal of minimizing the perception of poor performance due to the number of pages in a document. This inherently uses OptimizeFonts, for documents with a large number of fonts, font optimization can have poor performance, see SaveLinearizedNoOptimizeFonts as an alternative.

CollectGarbage

Collect Garbage by removing unreferenced objects. Only valid with Full.

KeepModDate

Do not update the Modification Date

CloseAfterSave

Close document after save. Use this flag for saving to the stream only. Note that using this flag to save a document to any destination other than stream causes an exception.

XMPPacketReadOnlyNoPadding

Save XMP data as read-only without padding

Uncompressed

Do not use object stream compression. Only valid with Full.

Compressed

Use object compression wherever possible. Only valid with Full.

CompressStructureOnly

Use object compression only for Logical Structure items. Only valid with Full.

RemoveASCIIFilters

Remove the ASCII85 filter from all streams where its in use. Only valid with Full.

AddFlate

Encode any uncompressed stream witht the Flate filter. Only valid with Full.

ReplaceLZW

Replace any LZW encoded stream with Flate. Only valid with Full.

OptimizeXObjects

Merge identical XObjects.

OptimizeContentStreams

Optimize Content Streams operators where possible.

OptimizeFonts

Merge Font Descriptors and encoding where possible. For documents with a large number of fonts, font optimization can have poor performance, this should only be set if necessary.

OptimizeMarkedJBIG2Dictionaries

Delete symbols specific to JBIG2 Dictionaries that couldn't be removed previously.

Ensure7bitASCII

Deprecated.

AutoSave

Deprecated.

DoNotCreateToUnicodeWidths

Don't create /ToUnicode and /Widths entries for Fonts to improve performance.

SaveOriginalMetadata

Save original /Metadata stream of input as /Metadata stream of output document.

SaveLinearizedNoOptimizeFonts

Save the document as Linearized the same as Linearized but OptimizeFonts is disabled. For documents with a large number of fonts, font optimization can have poor performance and is often unnecessary.