Penguin
Recent Changes
Annotated edit history of psnup(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PSNUP
2 !!!PSNUP
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 AUTHOR
8 SEE ALSO
9 TRADEMARKS
10 BUGS
11 ----
12 !!NAME
13
14
15 psnup - multiple pages per sheet
16 !!SYNOPSIS
17
18
19 __psnup__ [[ __-w__''width'' ] [[
20 __-h__''height'' ] [[ __-p__''paper'' ] [[
21 __-W__''width'' ] [[ __-H__''height'' ] [[
22 __-P__''paper'' ] [[ __-l__ ] [[ __-r__ ] [[
23 __-f__ ] [[ __-c__ ] [[ __-m__''margin'' ] [[
24 __-b__''border'' ] [[ __-d__''lwidth'' ] [[
25 __-s__''scale'' ] [[ __-__''nup'' ] [[ __-q__ ]
26 [[ ''infile'' [[ ''outfile'' ] ]
27 !!DESCRIPTION
28
29
30 ''Psnup'' puts multiple logical pages onto each physical
2 perry 31 sheet of paper. The input !PostScript file should follow the
1 perry 32 Adobe Document Structuring Conventions.
33
34
35 The ''-w'' option gives the paper width, and the
36 ''-h'' option gives the paper height, normally specified
2 perry 37 in __cm__ or __in__ to convert !PostScript's points
1 perry 38 (1/72 of an inch) to centimeters or inches. The ''-p''
39 option can be used as an alternative, to set the paper size
40 to __a0, a1, a2, a3, a4, a5, b5, letter, legal, tabloid,
41 statement,__ executive, folio, quarto or __10x14.__ The
42 default paper size is normally __a4,__ but on a Debian
43 system, /etc/papersize is consulted. The ''-W, -H,'' and
44 ''-P'' options set the input paper size, if it is
45 different from the output size. This makes it easy to impose
46 pages of one size on a different size of paper.
47
48
49 The ''-l'' option should be used for pages which are in
50 landscape orientation (rotated 90 degrees anticlockwise).
51 The ''-r'' option should be used for pages which are in
52 seascape orientation (rotated 90 degrees clockwise), and the
53 ''-f'' option should be used for pages which have the
54 width and height interchanged, but are not
55 rotated.
56
57
58 ''Psnup'' normally uses `row-major' layout, where
59 adjacent pages are placed in rows across the paper. The
60 ''-c'' option changes the order to `column-major', where
61 successive pages are placed in columns down the
62 paper.
63
64
65 A margin to leave around the whole page can be specified
66 with the ''-m'' option. This is useful for sheets of
67 `thumbnail' pages, because the normal page margins are
68 reduced by putting multiple pages on a single
69 sheet.
70
71
72 The ''-b'' option is used to specify an additional margin
73 around each page on a sheet.
74
75
76 The ''-d'' option draws a line around the border of each
77 page, of the specified width. If the ''lwidth'' parameter
78 is omitted, a default linewidth of 1 point is assumed. The
79 linewidth is relative to the original page dimensions,
80 ''i.e.'' it is scaled down with the rest of the
81 page.
82
83
84 The scale chosen by ''psnup'' can be overridden with the
85 ''-s'' option. This is useful to merge pages which are
86 already reduced.
87
88
89 The ''-nup'' option selects the number of logical pages
90 to put on each sheet of paper. This can be any whole number;
91 ''psnup'' tries to optimise the layout so that the
92 minimum amount of space is wasted. If ''psnup'' cannot
93 find a layout within its tolerance limit, it will abort with
94 an error message. The alternative form ''i nup'' can also
95 be used, for compatibility with other n-up
96 programs.
97
98
99 ''Psnup'' normally prints the page numbers of the pages
100 re-arranged; the ''-q'' option suppresses
101 this.
102 !!EXAMPLES
103
104
105 The potential use of this utility is varied but one
106 particular use is in conjunction with ''psbook(1).'' For
2 perry 107 example, using groff to create a !PostScript document and lpr
1 perry 108 as the UNIX print spooler a typical command
109 line might look like this:
110
111
112 groff -Tps -ms ''file'' | psbook | psnup -2 |
113 lpr
114
115
116 Where file is a 4 page document this command will result in
117 a two page document printing two pages of ''file'' per
118 page and rearranges the page order to match the input pages
119 4 and 1 on the first output page and pages 2 then 3 of the
120 input document on the second output page.
121 !!AUTHOR
122
123
124 Copyright (C) Angus J. C. Duggan 1991-1995
125 !!SEE ALSO
126
127
128 psbook(1), psselect(1), pstops(1), epsffit(1), psnup(1),
129 psresize(1), psmerge(1), fixscribeps(1), getafm(1),
130 fixdlsrps(1), fixfmps(1), fixmacps(1), fixpsditps(1),
131 fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1),
132 fixwwps(1), extractres(1), includeres(1)
133 !!TRADEMARKS
134
135
2 perry 136 __!PostScript__ is a trademark of Adobe Systems
1 perry 137 Incorporated.
138 !!BUGS
139
140
141 ''Psnup'' does not accept all DSC comments.
142 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.