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

NAME

6       pstops - shuffle pages in a PostScript file
7

SYNOPSIS

9       pstops  [ -q ] [ -b ] [ -wwidth ] [ -hheight ] [ -ppaper ] [ -dlwidth ]
10       pagespecs [ infile [ outfile ] ]
11

DESCRIPTION

13       Pstops rearranges pages from a  PostScript  document,  creating  a  new
14       PostScript  file.   The  input  PostScript file should follow the Adobe
15       Document Structuring Conventions.  Pstops can  be  used  to  perform  a
16       large  number  of  arbitrary  re-arrangements  of  Documents, including
17       arranging for printing 2-up, 4-up, booklets, reversing, selecting front
18       or back sides of documents, scaling, etc.
19
20       pagespecs follow the syntax:
21
22              pagespecs   = [modulo:]specs
23
24              specs       = spec[+specs][,specs]
25
26              spec        = [-]pageno[L][R][U][@scale][(xoff,yoff)]
27
28       modulo is the number of pages in each block. The value of modulo should
29       be greater than 0; the default value is 1.  specs are the page specifi‐
30       cations  for  the  pages in each block. The value of the pageno in each
31       spec should be between 0 (for the first page in the block) and modulo-1
32       (for  the  last page in each block) inclusive.  The optional dimensions
33       xoff and yoff shift the page by the specified amount.   xoff  and  yoff
34       are  in  PostScript's points, but may be followed by the units cm or in
35       to convert to centimetres or inches, or the flag w or h to specify as a
36       multiple  of  the width or height.  The optional parameters L, R, and U
37       rotate the page left, right, or upside-down.  The optional scale param‐
38       eter  scales the page by the fraction specified.  If the optional minus
39       sign is specified, the page is relative to the  end  of  the  document,
40       instead of the start.
41
42       If  page  specs  are  separated  by + the pages will be merged into one
43       page; if they are separated by  they will be  on  separate  pages.   If
44       there  is only one page specification, with pageno zero, the pageno may
45       be omitted.
46
47       The shift, rotation, and scaling are performed in that order regardless
48       of which order they appear on the command line.
49
50       The  -w  option gives the width which is used by the w dimension speci‐
51       fier, and the -h option gives the height which is used by the h  dimen‐
52       sion  specifier.  These dimensions are also used (after scaling) to set
53       the clipping path for each page.  The -p  option  can  be  used  as  an
54       alternative,  to  set  the paper size to a3, a4, a5, b5, letter, legal,
55       tabloid, statement, executive, folio, quarto, 10x14  or  _glibc,  where
56       latter  one  means  the format of the current locale. The default paper
57       size is _glibc.
58
59       The -b option prevents any bind operators in the PostScript prolog from
60       binding.  This  may  be  needed  in  cases where complex multi-page re-
61       arrangements are being done.
62
63       The -d option draws a line around the border of each page, of the spec‐
64       ified  width.   If the lwidth parameter is omitted, a default linewidth
65       of 1 point is assumed. The linewidth is relative to the  original  page
66       dimensions, i.e. it is scaled up or down with the rest of the page.
67
68       Pstops  normally  prints the page numbers of the pages re-arranged; the
69       -q option suppresses this.
70

EXAMPLES

72       This section contains some sample re-arrangements. To put two pages  on
73       one sheet (of A4 paper), the pagespec to use is:
74
75                         2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
76
77       To select all of the odd pages in reverse order, use:
78
79                                        2:-0
80
81       To re-arrange pages for printing 2-up booklets, use
82
83                        4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
84
85       for the front sides, and
86
87                        4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
88
89       for the reverse sides (or join them with a comma for duplex printing).
90

ENVIRONMENT VARIABLES

92       LC_ALL, LC_PAPER
93              These  variables are specifying the papertype when used paper is
94              _glibc.  For details see the locale(7) manpage.
95

AUTHOR

97       Copyright (C) Angus J. C. Duggan 1991-1995
98

SEE ALSO

100       psbook(1), psselect(1), pstops(1), epsffit(1),  psnup(1),  psresize(1),
101       psmerge(1), fixscribeps(1), getafm(1), fixdlsrps(1), fixfmps(1), fixps‐
102       ditps(1), fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1),
103       extractres(1), includeres(1)
104

TRADEMARKS

106       PostScript is a trademark of Adobe Systems Incorporated.
107

BUGS

109       Pstops does not accept all DSC comments.
110
111
112
113                        PSUtils Release 1 Patchlevel 17              PSTOPS(1)
Impressum