1PSNUP(1)                    General Commands Manual                   PSNUP(1)
2
3
4

NAME

6       psnup - multiple pages per sheet
7

SYNOPSIS

9       psnup  [-wwidth]  [-hheight]  [-ppaper]  [-Wwidth] [-Hheight] [-Ppaper]
10       [-l|-r|-f] [-c] [-mmargin]  [-bborder]  [-d[lwidth]]  [-sscale]  [-nup]
11       [-q] [infile [outfile]]
12

DESCRIPTION

14       Psnup  puts  multiple  logical pages onto each physical sheet of paper.
15       The input PostScript file should follow the Adobe Document  Structuring
16       Conventions.
17
18       The  -w option gives the paper width, and the -h option gives the paper
19       height, specified in pt, mm, cm, or in.  The  -p  option  can  be  used
20       instead, to set the paper size; otherwise a default value is used.  See
21       paper(1).  The -W, -H, and -P options set the input paper size,  if  it
22       is  different  from the output size. This makes it easy to impose pages
23       of one size on a different size of paper.
24
25       The -l option should be used for pages which are in landscape  orienta‐
26       tion  (rotated  90 degrees anticlockwise). The -r option should be used
27       for pages which are in seascape orientation (rotated 90 degrees  clock‐
28       wise),  and the -f option should be used for pages which have the width
29       and height interchanged, but are not rotated.
30
31       Psnup normally uses `row-major' layout, where adjacent pages are placed
32       in  rows across the paper.  The -c option changes the order to `column-
33       major', where successive pages are placed in columns down the paper.
34
35       A margin to leave around the whole page can be specified  with  the  -m
36       option.  This  is  useful  for sheets of `thumbnail' pages, because the
37       normal page margins are reduced by putting multiple pages on  a  single
38       sheet.
39
40       The  -b option is used to specify an additional margin around each page
41       on a sheet.
42
43       The -d option draws a line around the border of each page, of the spec‐
44       ified  width.   If the lwidth parameter is omitted, a default linewidth
45       of 1 point is assumed. The linewidth is relative to the  original  page
46       dimensions, i.e., it is scaled down with the rest of the page.
47
48       The scale chosen by psnup can be overridden with the -s option. This is
49       useful to merge pages which are already reduced.
50
51       The -nup option selects the number of logical  pages  to  put  on  each
52       sheet  of  paper. This can be any whole number; psnup tries to optimise
53       the layout so that the minimum amount of space is wasted. If psnup can‐
54       not  find  a  layout  within its tolerance limit, it will abort with an
55       error message. The alternative form -nnup can also be used, for compat‐
56       ibility with other n-up programs.
57
58       Psnup normally prints the page numbers of the pages re-arranged; the -q
59       option suppresses this.
60

EXAMPLES

62       The potential use of this utility is varied but one particular  use  is
63       in  conjunction  with  psbook(1).  For example, using groff to create a
64       PostScript document and lpr as the UNIX print spooler a typical command
65       line might look like this:
66
67       groff -Tps -ms file | psbook | psnup -2 | lpr
68
69       where  file is a 4 page document this command will result in a two page
70       document printing two pages of file per page and  rearranges  the  page
71       order  to  match  the  input pages 4 and 1 on the first output page and
72       pages 2 then 3 of the input document on the second output page.
73

AUTHOR

75       Written by Angus J. C. Duggan.
76

SEE ALSO

TRADEMARKS

79       PostScript is a trademark of Adobe Systems Incorporated.
80

BUGS

82       Psnup does not accept all DSC comments.
83
84
85
86                                    PSUtils                           PSNUP(1)
Impressum