explicit-page-placement

Identifies the enhanced n-up function requested with this document. However, this function is only available on printers that support enhanced n-up. This attribute is ignored unless the output-format attribute is specified.

DSS

PSF, Email

Type

Resettable, single-valued, per-document

Allowed Values

This attribute uses a limited version of the Place subcommand from the Page Printer Formatting Aid (PPFA). Here is the syntax for the subcommand:

Place subcommand

Place {n {Front | Back} Offset [x-pos] [y-pos] 
Rotation [0 | 90 | 180 | 270}

Place

Places a page of data or a constant modification relative to a partition. Each set of Place subcommands defines an enhanced partition. Each n partition can have its own front, back, offset, and rotation setting. You must specify the same number of Place subcommands as the number of partitions on the sheet. The number of Place subcommands should equal (number-up * sides). Failure to specify the proper number of Place subcommands results in an error. The sequence of the Place subcommand is the sequence in which the incoming pages will be placed in the partitions.

n {Front | Back}

• Specifies the numbered partition (1–4) into which the page of data is placed.

  Front

  Specifies that this partition is placed on the front side of the sheet. This is the default when a partition number is specified and neither Front nor Back are specified.

  Back

  Specifies that this partition is placed on the back side of the sheet.

• When you specify Front or Back, you must also specify a partition number with n.

Offset x-posy-pos

• x-pos specifies a positive or negative offset of the page horizontally.

  y-pos specifies a positive or negative offset of the page vertically.

  When you specify Offset, you must specify both the x-pos and y-pos values.

  If Offset is not specified, InfoPrint Manager uses the value of 0 (zero) for both the x- and y-offsets. The specified or default offset is used over any other image shifts specified with the x-image-shift, y-image-shift, x-image-shift-back, or y-image-shift-back attributes.

  You can specify the units in inches (in), millimeters (mm), centimeters (cm), or points. If you do not specify a unit of measure for Offset, InfoPrint Manager uses a default unit of measure value of inches.

Rotation {0 | 90 | 180 | 270}

Specifies the clockwise rotation of the page placed by this command. Rotation turns the page around its fixed origin points. If you rotate the page without moving its origin point, you might rotate it off the physical medium. To prevent this, always offset the origin to the place you want to be for the rotated page.

Examples

• 3–up example

  This example is for 3–up duplex where the first and last pages are shifted in toward the center page. All placements are from partition 1:

  explicit-page-placement='PLACE 1 OFFSET 1.0 1.0 
                           PLACE 1 OFFSET 7.0 1.0 
                           PLACE 1 OFFSET 13.0 1.0 
                           PLACE 1 BACK OFFSET 1.0 1.0 
                           PLACE 1 BACK OFFSET 7.0 1.0 
                           PLACE 1 BACK OFFSET 13.0 1.0'

  Which results in a document with the front side that looks like:

  Results of the explict-page-placement attribute showing a 3–up page offset from partition 1

  

• 2-up example

  This example is for printing 2-up tumble duplex with rotation:

  explicit-page-placement='PLACE 1 OFFSET 1.500 IN 6.000 IN ROTATION 270 
                           PLACE 2 OFFSET 0 IN 6.000 IN ROTATION 270 
                           PLACE 1 BACK OFFSET 1.500 IN 8.500 IN ROTATION 270 
                           PLACE 2 BACK OFFSET 0 IN 8.500 IN ROTATION 270'

  Which results in a document that looks like:

  Results of the explict-page-placement attribute showing a 2–up tumble duplex with rotation

  

Default Value

No default value

Usage Guidelines

• The syntax of the data provided is not checked until the job is scheduled to print. Syntax errors detected at print time cause the job to abort.
• This attribute is ignored unless the output-format attribute is specified.
• When you use the explicit-page-placement attribute, page data that is outside of the partition prints as long as it fits on the media.
• This attribute is not valid for ASCII documents.
• This attribute is not valid for PSF-command or other-driver destinations.
• If you specify a value for the form-definition document attribute, InfoPrint ignores the explicit-page-placement attribute and uses the page placement information in the form definition.