version 2 showing authors affecting page license.
.
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 |
|
|
|
15 |
pstops - shuffle pages in a !PostScript file |
|
|
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 |
|
|
|
27 |
''Pstops'' rearranges pages from a !PostScript document, |
|
|
28 |
creating a new !PostScript file. The input !PostScript file |
|
|
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. |
|
|
66 |
''xoff'' and ''yoff'' are in !PostScript's points, but |
|
|
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 |
|
|
86 |
!PostScript transformation matrix in that order regardless of |
|
|
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 |
|
|
106 |
the !PostScript prolog from binding. This may be needed in |
|
|
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 |
|
|
|
153 |
__!PostScript__ is a trademark of Adobe Systems |
|
|
154 |
Incorporated. |
|
|
155 |
!!BUGS |
|
|
156 |
|
|
|
157 |
|
|
|
158 |
''Pstops'' does not accept all DSC comments. |
|
|
159 |
---- |