VMS Help
PRINT Parameter, LAYUP_DEFINITION
*Conan The Librarian
|
LAYUP_DEFINITION=layup-definition-filename
LAYUP_DEFINITION="(option;...)"
Specifies layup options or a layup definition file that sets
the layup features. Layup features are borders, sheet margins,
alternating margins, pages per sheet, first page, page order,
and page grid.
Layup definition files are located in DCPS$LAYUP: and have the
file type LUP. Do not specify the file type when you specify
the layup definition file in the command line.
To use a layup option and NUMBER_UP together, you must specify
both on the command line or associate both with a queue.
Layup options allow you to specify the number of pages to
print on each sheet of paper, their position on a sheet, the
size of margins and whether borders are printed. The layup
options and the syntax for specifying values is as follows:
ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM]
[NO]BORDERS
FIRSTPAGE=n
GRID=columns,rows
MARGINS=t,b,l,r
PAGEORDER=
PAGESPERSHEET=n
You can specify layup options in either a layup definition
file, or in-line as part of the PRINT command.
You can specify layup definition options in your command line
by enclosing them in parentheses and separating them with
semi-colons. You must also enclose the entire layup
definition string in quotes, as follows:
$ PRINT /PARAMETERS=(LAYUP_DEFINITION="(option1;option2;...)")
See the Examples topic for examples of PRINT commands that
include in-line layup options.
ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM]
Shifts every other page image in preparation for two-sided
printing. Use this option in combination with the MARGINS
option.
Specify one of the words, LEFT, RIGHT, TOP or BOTTOM to
cause the DECprint Supervisor to shift alternate page side
images appropriately. Specifying LEFT or RIGHT alternates
the left and right margins you specify with the MARGINS
option (those margins along the long edge of a sheet of
paper). Specifying TOP or BOTTOM alternates the top and
bottom margins you specify.
If you specify ALTERNATE with no option values, left and
right margins alternate.
BORDERS
NOBORDERS
Draws a border around each page.
If you use the NUMBER_UP parameter, the default is to draw
borders around each page spot. Specify NOBORDERS to inhibit
drawing of borders.
The default is to draw page borders whenever the layup
feature is used.
FIRSTPAGE=value
Specifies the first page spot where a page will be printed.
You must specify a value to FIRSTPAGE. The value is the
number of the page spot on which to print the first page.
Page spots are numbered starting at 1.
The FIRSTPAGE option is useful for specifying how to print
pages when you need to preview the layout of pages for
documents with right and left pages. Without the FIRSTPAGE
option, pages are printed at all the page spots. You can
use FIRSTPAGE to print your layout in a way that reflects
proper right and left orientation.
The default is to use the first page spot on a sheet.
GRID=columns,rows
Sets the number of page spots on a sheet in columns and rows.
Specify columns and rows as the numbers of columns and rows
desired on each sheet side.
This option overrides the NUMBER_UP parameter.
MARGINS=t,b,l,r
Sets the margins for a sheet, where t is the top margin,
b is the bottom margin, l is the left margin and r is the
right margin. The numbers are interpreted as printer points,
where there are 72 points to an inch, or 28.35 points per
centimeter. Pages are scaled to fit within the margins.
PAGEORDER=value
Specifies the order in which pages appear on a sheet.
This can be thought of as the reading order of the pages.
You must supply one of the following values to PAGEORDER:
RightDown Pages ordered left to right, top to bottom
LeftDown Pages ordered right to left, top to bottom
RightUp Pages ordered left to right, bottom to top
LeftUp Pages ordered right to left, bottom to top
DownRight Pages ordered top to bottom, left to right
DownLeft Pages ordered top to bottom, right to left
UpRight Pages ordered bottom to top, left to right
UpLeft Pages ordered bottom to top, right to left
PAGESPERSHEET=value
Sets the number of pages that will print per sheet, no
matter how many page spots are set by the NUMBER_UP parameter.
The NUMBER_UP parameter or the GRID layup option determines
the maximum number of pages you can print for each sheet.
PAGESPERSHEET determines only the range of page spots to use;
not their layout.
You must supply a value to PAGESPERSHEET. The value must be
less than the value supplied to the NUMBER_UP parameter value.
The following PRINT commands illustrate the use of the layup
feature:
$ PRINT /PARAMETERS=(SIDES=2,LAYUP=LPS$DOUBLEHOLES) DOCUMENT.PS
prints DOCUMENT.PS using the DCPS-supplied layup definition file
LPS$DOUBLEHOLES to alternate page side images for edge-binding.
$ PRINT /PARAMETERS=(SIDES=2,NUMBER_UP=2,LAYUP="(NOBORDERS)") MAIL.TXT
prints the file MAIL.TXT as two-sided, two-pages per side and
with no page borders.
$ PRINT /PARAMETERS= -
_$ (LAYUP="(MARGINS=20,20,60,20;NOBORDERS;ALTERNATE=LEFT)", -
_$ SIDES=2,PAGE_ORIENTATION=LANDSCAPE) -
_$ MONTHLY_REPORT.TXT
prints the file MONTHLY_REPORT.TXT with landscape orientation,
alternating page images across the long-edge margin.