OVERLAY

Top  Previous  Next

Syntax

 

overlay "pdffile"|{fileexpr}, page|{numexpr}, pclleft|{numexpr}, pcltop|{numexpr}, resolution|{numexpr}

 

Description

 

The overlay command is used to place a specified page of a PDF file as a background on the printed page.  This command relies on Ghostscript being configured at the server or available via the Windows Support Server.  The specified page is extracted to an image and placed as a full page background.

 

The pclleft and pcltop values are used as offsets to the upper-left corner of the image, to accommodate margins within the pdf file.  Both numbers are entered as pixels, so related to the resolution.  Resolution defaults to the rule set's dpi, or 300 if not set.  All parameters can be expressions. Pcl offsets are ignored in ps and pdf output.

 

PostScript Note

 

When producing PostScript output, the overlay command (more specifically, Ghostscript) produces an EPS overlay that contains features that require PostScript 3.  The -p ps and -p ps3 command line options have no effect on this.

 

Example:

 

overlay "invoice_image.pdf",1

 

overlay {backdrop$},1,75,75,300

 

Drivers: pcl, ps, pdf