DynaPDF Manual - Page 764

Previous Page 763   Index   Next Page 765

Function Reference
Page 764 of 818
= 0x00400000, // EN 16931 profile
= 0x00800000, // Extended profile
= 0x01000000
// If set, a ZUGFeRD 2.0 will be created.
The function changes the output file version. The default output version is PDF 1.4. 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.
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.
ZUGFeRD, ZUGFeRD 2.0, Factur-X / ZUGFeRD 2.1
ZUGFeRD 2.0 and Factur-X are almost identically defined. Both standards support the very same
profiles. To create a ZUGFeRD 2.0 invoice with the profile Basic WL, for example, set the PDF
version as follows:
pdfSetPDFVersion(pdf, TPDFVersion(pvFacturX_Basic_WL | pvZUGFeRD2_Flag));
The PDF version is set to PDF/A 3b in the above example. If you want to create the very same
invoice but as PDF/A 3u file, for example, then set also the whished output PDF version:
pdfSetPDFVersion(pdf, TPDFVersion(pvPDFA_3u | pvFacturX_Basic_WL | pvZUGFeRD2_Flag));
Note that this function just sets the PDF version. It does not check whether the resulting file is
compatible to the whished output version. Use CheckConformance() to convert arbitrary PDF files
to PDF/A, ZUGFeRD, or Factur-X files.
Factur-X and ZUGFeRD 2.1 are identically defined in PDF. Therefore, the Factur-X constants can be
used to create Factur-X and ZUGFeRD 2.1 files. The PDF container cannot distiguish between these
ZUGFeRD and Factur-X invoices require an embedded XML invoice. The XML file can be attached
with AttachFile() or AttachFileEx().

Previous topic: SetPageWidth, SetPDFVersion

Next topic: SetPrintSettings

Start Chat