PeachDrawing.PDF.PdfComposer

PdfComposer.Configure(PdfComposerOptions) Method

Applies options to the document: fixes its format (version, conformance, color management, encryption, embedded files, compression), writes the document information, and writes whatever the claimed conformance level requires (the output intent, the XMP packet).

public void Configure(PeachDrawing.PDF.PdfComposerOptions options);

Parameters

options PdfComposerOptions

the options to apply; read now, not kept

Exceptions

System.InvalidOperationException
the options contradict each other (a PDF/A level with encryption, a PDF 2.0 file with a PDF/A-1 level, an XMP packet with no creation date, ...) or differ from the format an earlier call fixed

Remarks

The constructor calls this with the options it is given. Call it again to write more or newer document information: the information is replaced by the non-empty values of the new options, and the XMP packet is rewritten. The format settings are a whole-document property and are fixed by the first call; a later call must ask for the same ones, and one that does not is rejected rather than leaving a file whose header or conformance claim disagrees with how some pages were written.

Everything that can be checked from the options alone is checked here, before anything is drawn, so a document that is about to be rejected wastes no work.