Penguin
Recent Changes
Annotated edit history of pstops(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PSTOPS
2 !!!PSTOPS
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 AUTHOR
8 SEE ALSO
9 TRADEMARKS
10 BUGS
11 ----
12 !!NAME
13
14
2 perry 15 pstops - shuffle pages in a !PostScript file
1 perry 16 !!SYNOPSIS
17
18
19 __pstops__ [[ __-q__ ] [[ __-b__ ] [[
20 __-w__''width'' ] [[ __-h__''height'' ] [[
21 __-p__''paper'' ] [[ __-d__''lwidth'' ]
22 ''pagespecs'' [[ ''infile'' [[ ''outfile'' ]
23 ]
24 !!DESCRIPTION
25
26
2 perry 27 ''Pstops'' rearranges pages from a !PostScript document,
28 creating a new !PostScript file. The input !PostScript file
1 perry 29 should follow the Adobe Document Structuring Conventions.
30 ''Pstops'' can be used to perform a large number of
31 arbitrary re-arrangements of Documents, including arranging
32 for printing 2-up, 4-up, booklets, reversing, selecting
33 front or back sides of documents, scaling, etc.
34
35
36 ''pagespecs'' follow the syntax:
37
38
39 ''pagespecs''
40
41
42 ''= [[modulo:]specs''
43
44
45 ''specs''
46
47
48 ''= spec[[+specs][[,specs]''
49
50
51 ''spec''
52
53
54 ''=
55 [[-]pageno[[L][[R][[U][[@scale][[(xoff,yoff)]''
56
57
58 ''modulo'' is the number of pages in each block. The
59 value of ''modulo'' should be greater than 0; the default
60 value is 1. ''specs'' are the page specifications for the
61 pages in each block. The value of the ''pageno'' in each
62 ''spec'' should be between 0 (for the first page in the
63 block) and ''modulo''-1 (for the last page in each block)
64 inclusive. The optional dimensions ''xoff'' and
65 ''yoff'' shift the page by the specified amount.
2 perry 66 ''xoff'' and ''yoff'' are in !PostScript's points, but
1 perry 67 may be followed by the units __cm__ or __in__ to
68 convert to centimetres or inches, or the flag __w__ or
69 __h__ to specify as a multiple of the width or height.
70 The optional parameters ''L'', ''R'', and ''U''
71 rotate the page left, right, or upside-down. The optional
72 ''scale'' parameter scales the page by the fraction
73 specified. If the optional minus sign is specified, the page
74 is relative to the end of the document, instead of the
75 start.
76
77
78 If page ''spec''s are separated by __+__ the pages
79 will be merged into one page; if they are separated by
80 __,__ they will be on separate pages. If there is only
81 one page specification, with ''pageno'' zero, the
82 ''pageno'' may be omitted.
83
84
85 The shift, rotation, and scaling are applied to the
2 perry 86 !PostScript transformation matrix in that order regardless of
1 perry 87 which order they appear on the command line. The matrix
88 accumulates the individual transformations. The effect on
89 the image is to first scale with respect to an origin at the
90 lower left corner, then rotate about the same origin, and
91 finally shift.
92
93
94 The ''-w'' option gives the width which is used by the
95 __w__ dimension specifier, and the ''-h'' option gives
96 the height which is used by the __h__ dimension
97 specifier. These dimensions are also used (after scaling) to
98 set the clipping path for each page. The ''-p'' option
99 can be used as an alternative, to set the paper size to
100 __a0, a1, a2, a3, a4, a5, b5, letter, legal, tabloid,
101 statement,__ executive, folio, quarto or __10x14.__ The
102 default paper size is __a4.__
103
104
105 The ''-b'' option prevents any __bind__ operators in
2 perry 106 the !PostScript prolog from binding. This may be needed in
1 perry 107 cases where complex multi-page re-arrangements are being
108 done.
109
110
111 The ''-d'' option draws a line around the border of each
112 page, of the specified width. If the ''lwidth'' parameter
113 is omitted, a default linewidth of 1 point is assumed. The
114 linewidth is relative to the original page dimensions,
115 ''i.e.'' it is scaled up or down with the rest of the
116 page.
117
118
119 Pstops normally prints the page numbers of the pages
120 re-arranged; the ''-q'' option suppresses
121 this.
122 !!EXAMPLES
123
124
125 This section contains some sample re-arrangements. To put
126 two pages on one sheet (of A4 paper), the pagespec to use
127 is:
128 2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
129 To select all of the odd pages in reverse order,
130 use:
131 2:-0
132 To re-arrange pages for printing 2-up booklets, use
133 4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
134 for the front sides, and
135 4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
136 for the reverse sides (or join them with a comma for
137 duplex printing).
138 !!AUTHOR
139
140
141 Copyright (C) Angus J. C. Duggan 1991-1995
142 !!SEE ALSO
143
144
145 psbook(1), psselect(1), pstops(1), epsffit(1), psnup(1),
146 psresize(1), psmerge(1), fixscribeps(1), getafm(1),
147 fixdlsrps(1), fixfmps(1), fixmacps(1), fixpsditps(1),
148 fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1),
149 fixwwps(1), extractres(1), includeres(1)
150 !!TRADEMARKS
151
152
2 perry 153 __!PostScript__ is a trademark of Adobe Systems
1 perry 154 Incorporated.
155 !!BUGS
156
157
158 ''Pstops'' does not accept all DSC comments.
159 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.