IMAGES

Syntax

images "filelist"|{expr} [,across n] [,down n] [,res|resolution n] [,color] [,tray value|{expr}]

Description

Appends image files from the filelist, which can be a literal or an expression.  The list may contain any number of semi-colon delimited file names.  Each is converted to an image in sequence and added to pages following the current page, optionally scaled and tiled based on the across and down options.  

The images are produced at 300 dpi unless otherwise specified.  The images will by default be produced in black and white unless color images are indicated with a uf101c –color (or –ci) command line option, or if the color option is specified in the images command.

If a file in the list is a PDF file, and the job's output is in PDF format, and there is no tile or resolution setting, then PDF pages are inserted in vector format rather than being converted to images first. This improves performance and will normally result in smaller PDF output.  

Support for PDF files requires Ghostscript availability.  Support for image files requires Image Magick availability.

The tray option is provided to draw paper from the tray specified for the pages produced by the image attachments.  The tray value should match the syntax found in the tray command, or can be an expression that produces an equivalent text value.

An images command may be placed inside an 'if copy' block or be run with an exec() command in a code block in order to append images only on selected copies or pages.

Examples

images "termsconditions1.jpg;termsconditions2.jpg"

images {all_invoices$},across 2, down 2, resolution 150, tray 5

images "terms.pdf"

Drivers: pcl, pdf, postscript