Navigation:  External interfaces > PDF interface

 

BASICS

 

Prerequisite: you must be familiar with vpxPrint general coding.

 

To preserve the previous easy-coding of vpxPrint, we have made this PDF export as easy to use as possible.

 

1. The additional tags:

The only mandatory tag to use is the <PDF-OUTPUT> tag, which defines the output file name. Some additional tags will help you to customize your PDF.

 

Specific PDF tags:

<PDF-OUTPUT>                starts the PDF output.

<PDF-TITLE>                        specific PDF report title,

<PDF-AUTHOR>                PDF author,

<PDF-SUBJECT>                subject,

<PDF-KEYWORDS>                keywords,

<PDF-USERPASSWORD>        user password,

<PDF-OWNERPASSWORD>        owner password,

<PDF-ENCRYPT>                PDF Encryption,

<PDF-ENABLE>                Permissions for the file,

<PDF-FONTS>                        Font management,

<PDF-TOP>                        Top margin,

<PDF-LEFT>                        Left margin

<PDF-EXCLUDE>                Excludes embedding of specific fonts

<PDF=DIRECT>                Creates the PDF file directly. No extra memory is needed for the preview.

                                 Consider using this option when large PDF files are created with vpxPrint.

                                 This option must be put at the beginning of the file.

 

<PDF-OUTLINE>                New outline entry

<PDF-A>                        PDF-A file format

 

The minimum code to insert in your report is:

 <PDF-OUTPUT=C:\myPDFfiles\report.pdf>        to set the output file name

 

2. The vpxPrint interface:

As a specific user name and password must be provided to the PDF interface, a new entry point has been added printPDF. This entry point is included in the new xPrint.i include file.

In the version 7, you don't need to use printPDF() method to send the PDF license key anymore. These keys are now included in the license file (xPrint.lic).

The printPDF() method is kept for compatibilities issues.

 

Run printPDF( <vpxPrint file name>, <PDF User name>, <PDF Registration key> ).

 

The <PREVIEW=PDF> option uses the Acrobat Reader engine to preview the report instead of the standard vpxPrint preview.

 

LIMITATIONS

 

Limitations :

Due to the nature and functionalities of PDF and vpxPrint, limitations or differences exist between the outputs. Some of them could be bypassed in the future, but at this time, the following applies: