DynaPDF Manual - Page 815

Previous Page 814   Index   Next Page 816

Function Reference

Page 815 of 874

The function changes the output file version. The default output version is PDF 1.5. If a PDF file

with a higher version as curently set will be imported, then the file version is adjusted to the version

of the imported file.

Note that not all available versions can be created by DynaPDF. However, DynaPDF is able to

identify all versions listed above when importing a PDF file. A known version will not be stripped

out when saving a PDF file with DynaPDF.

To improve processing speed, the output version is not checked at runtime and no features are

disabled which are maybe not supported by the current PDF version.

However, if a PDF file must be compatible to a specific Acrobat version, change the version and

open the file in Adobe's Acrobat. If error messages or other warnings appear, the file contains

unsupported features. For example, Unicode output is supported since PDF 1.3. If the output

version will be changed to PDF 1.2, you will get an error message in Adobe's Acrobat if the file

contains CID fonts (Unicode fonts). There is no other known feature that causes errors when

opening a PDF file with Acrobat or Reader.

To create PDF/X or PDF/A compatible files we recommended to use a preflight tool to check

whether unsupported features were used or whether additional settings are required to meet the

requirements of the standard. The PDF version should be set at the end of processing, directly

before CloseFile() or CloseFileEx() is called. See also PDF/X and PDF/X Compatibility.

SetPrintSettings

Syntax:

LBOOL pdfSetPrintSettings(

const PPDF* IPDF,

// Instance pointer

TDuplexMode Mode,

// See below

SI32 PickTrayByPDFSize,

// 1 = true, 0 = false, -1 = app default

UI32 NumCopies,

// 0 = app default, max = 5

TPrintScaling PrintScaling, // See below

UI32* PrintRanges,

// Optional start/end page number pairs

UI32 NumRanges)

// Number of ranges

typedef enum

{

dpmNone, // Default

dpmSimplex,

dpmFlipShortEdge,

dpmFlipLongEdge

}TDuplexMode;

typedef enum

{

psAppDefault, // Default

psNone

}TPrintScaling;

The function adds preferred print settings to the PDF file. Viewer applications use the print settings

to initialize the print dialog. Print ranges, if set, consist of two numbers which define the start and

end page number that should be printed.

Previous topic: SetPDFVersion

Next topic: SetProgressProc