CERN Accelerating science

This website is no longer maintained. Its content may be obsolete. Please visit for current CERN information.

next up previous
Next: psselect---select pages from Up: PostScript tools Previous: psbook---rearrange pages in

psnup---multiple pages per sheet

psnup [ -w\Larg{width} ] [ -h\Larg{height} ] [ -p\Larg{paper} ] 
      [ -l ] [ -r ] [ -f ] [ -c ] [ -m\Larg{margin} ] 
      [ -b\Larg{border} ]  [ -d\Larg{lwidth} ] [ -s\Larg{scale} ] 
      [ -\Larg{nup} ] [ -q ]    [ infile [ outfile ] ]

The program psnup, written by Angus Duggan, puts multiple logical pages onto each physical sheet of paper. The input PostScript file should follow the Adobe Document Structuring Conventions.


Specifies an additional margin around each page on a sheet.
Use ``column-major'' order, i.e. place successively in columns down the paper. By default psnup uses a ``row-major'' layout, where adjacent pages are placed in rows across the paper.
Draws a line around the border of each page, of the specified width. If the lwidth parameter is omitted, a default linewidth of 1 pt is assumed. The linewidth is relative to the original page dimensions, i.e. it is scaled up or down with the rest of the page.
The height and width of the page are interchanged but the page is not rotated.
The height of the paper (usually in cm or in).
The orientation of the page is landscape (rotated 90 anticlockwise).
Leave a margin of value margin around the whole page. This is useful for sheets of ``thumb-nail' pages, because the normal page margins are reduced by putting multiple pages on a single sheet.
The number of logical pages to put on each sheet of paper. This can be any whole number; psnup tries to optimise the layout so that the minimum amount of space is wasted. If psnup cannot find a layout within its tolerance limit, it will abort with an error message.
Alternative to set the paper size to a3, a4, a5, b5, letter, legal, tabloid, statement, executive, folio, quarto or 10x14 (default paper size is a4).
Suppress printing the page numbers of the pages being rearranged (default all page numbers are printed).
The orientation of the page is seascape (rotated 90 clockwise).
Override the scale chosen by psnup with the value scale. This is useful to merge pages which are already reduced.
The width of the paper (usually in cm or in).


The potential uses of this utility are varied but one particular use is in conjunction with psbook. You can, for instance, use groff to create a PostScript document and lpr as the UNIX print spooler. Then a typical command could be something like the following:

groff -Tps -ms file | psbook | psnup -2 | lpr
When ``file'' is a four-page document this command will result in a two-page document printing two pages of file per page and rearranges the page order to match the input pages 4 and 1 on the first output page and pages 2 then 3 of the input document on the second output page.

next up previous
Next: psselect---select pages from Up: PostScript tools Previous: psbook---rearrange pages in

Janne Saarela
Tue May 16 13:43:26 METDST 1995