1 | .TH PSNUP 1 "19 August 1992" "Adobe Systems" |
---|
2 | \" Copyright (c) 1985,1987,1991,1992 Adobe Systems Incorporated. All Rights Reserved. |
---|
3 | \" ATTN GOVERNMENT END USERS: See notice of rights in file XPSLIBDIRX/Notice |
---|
4 | \" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/psnup.1p,v 1.1.1.1 1996-10-07 20:25:39 ghudson Exp $ |
---|
5 | .ds PS P\s-2OST\s+2S\s-2CRIPT\s+2 |
---|
6 | .SH NAME |
---|
7 | psnup\(emprint multiple pages on a sheet of paper. |
---|
8 | .SH SYNOPSIS |
---|
9 | .B psnup |
---|
10 | [ |
---|
11 | .B -rGf |
---|
12 | ] [ |
---|
13 | .BI -n nupspec |
---|
14 | ] [ |
---|
15 | .BI -S papersize |
---|
16 | ] [ |
---|
17 | .BI -s pagesize |
---|
18 | ] [ |
---|
19 | .BI -w pagewidth |
---|
20 | ] [ |
---|
21 | .BI -h pageheight |
---|
22 | ] |
---|
23 | .br |
---|
24 | [ |
---|
25 | .BI -p outputfile |
---|
26 | ] [ |
---|
27 | .BI -P printer |
---|
28 | ] [ |
---|
29 | .BI -d printer |
---|
30 | ] [ |
---|
31 | .I file |
---|
32 | ] |
---|
33 | .SH DESCRIPTION |
---|
34 | .I psnup |
---|
35 | reads in a \*(PS language |
---|
36 | .I file |
---|
37 | (or the standard input if no file is named) and, if the |
---|
38 | input conforms to the \*(PS language document structuring conventions, |
---|
39 | provides page rotation, printing of multiple pages on a sheet |
---|
40 | of paper (n-up printing), selection of page and paper sizes, |
---|
41 | and writes the resulting file on the standard output. The output |
---|
42 | may be directed to a file. |
---|
43 | .sp |
---|
44 | The possible options are: |
---|
45 | .TP |
---|
46 | .BI -n nupspec |
---|
47 | .I nupspec |
---|
48 | may be a single number specifying how many pages will be |
---|
49 | printed on each sheet of paper, or a specification of the form: |
---|
50 | .I n |
---|
51 | x |
---|
52 | .I m, |
---|
53 | where |
---|
54 | .I n |
---|
55 | and |
---|
56 | .I m |
---|
57 | specify rows and columns, respectively. Rows refers to |
---|
58 | the number of page images across a sheet of paper, columns to the |
---|
59 | number of page images down a sheet of paper. The specification |
---|
60 | .BI -n 2x2 |
---|
61 | is equivalent to the specification |
---|
62 | .BI -n 4. |
---|
63 | If the number of pages on a sheet is specified as a single |
---|
64 | number, the number must be a power of 2. |
---|
65 | .TP |
---|
66 | .B -r |
---|
67 | rotates the page 90 degrees (landscape mode). |
---|
68 | When using the n-up capability of |
---|
69 | .I psnup, |
---|
70 | this option |
---|
71 | is preferable to the landscape option of pslpr because the rotation of the page |
---|
72 | is taken into account when laying out multiple pages on a sheet of paper. |
---|
73 | .TP |
---|
74 | .BI -S papersize |
---|
75 | specifies size of paper for which output is to be formatted. The |
---|
76 | default is Letter (8.5 x 11). |
---|
77 | .TP |
---|
78 | .BI -s pagesize |
---|
79 | specifies the size of pages being printed n-up (i.e., the original size). The |
---|
80 | default is Letter (8.5 x 11). |
---|
81 | .TP |
---|
82 | .BI -w pagewidth |
---|
83 | if the size of the pages being printed n-up isn't a standard size, you can |
---|
84 | specify the width and height instead. Numbers followed by "i" will be |
---|
85 | interpreted in inches, by "m" in millimeters, and numbers without |
---|
86 | qualification will be interpreted as specifying the distance in points. |
---|
87 | .TP |
---|
88 | .BI -h pageheight |
---|
89 | specifies the height of the page being printed n-up. |
---|
90 | .TP |
---|
91 | .B -G |
---|
92 | formats the document in psnup's "gaudy" mode, with borders around the virtual |
---|
93 | pages. If no n-up specification is given, the input file is printed with |
---|
94 | four virtual pages per sheet of paper. |
---|
95 | .TP |
---|
96 | .BI -p outputfile |
---|
97 | writes output to the specified file. |
---|
98 | .BI-p - |
---|
99 | means write output to standard output. |
---|
100 | .TP |
---|
101 | .BI -P printername |
---|
102 | .TP |
---|
103 | .BI -d printername |
---|
104 | uses |
---|
105 | .IR printername's |
---|
106 | \*(PS Printer Description file for information about available paper sizes. |
---|
107 | The |
---|
108 | result is |
---|
109 | .IR not |
---|
110 | spooled to the printer. |
---|
111 | |
---|
112 | .SH EXAMPLES |
---|
113 | The following command reads a \*(PS language file called printfile.ps |
---|
114 | and formats it with four pages on a sheet of paper. The file is |
---|
115 | piped through pslpr to be printed on the printer called ps. |
---|
116 | |
---|
117 | .RS |
---|
118 | psnup -n4 printfile.ps | pslpr -Pps |
---|
119 | |
---|
120 | .RE |
---|
121 | In this example, a text file is processed by enscript, creating a \*(PS |
---|
122 | language file, which is piped to |
---|
123 | .I |
---|
124 | psnup, |
---|
125 | which rotates the file and formats it with three virtual pages across |
---|
126 | and two virtual pages down the paper. |
---|
127 | The formatted file is printed by piping the file through pslpr. |
---|
128 | |
---|
129 | .RS |
---|
130 | enscript -p- textfile | psnup -r -n3x2 | pslpr |
---|
131 | |
---|
132 | .RE |
---|
133 | In this example, a text file is processed by enscript, creating a \*(PS |
---|
134 | language file, which is piped to |
---|
135 | .I psnup, |
---|
136 | formatted in gaudy mode ( |
---|
137 | .B -G |
---|
138 | option), |
---|
139 | with four virtual pages per actual page of output. |
---|
140 | The formatted file is printed by piping the file through pslpr. The |
---|
141 | result is printed pages with four original text pages on each sheet, with each |
---|
142 | original text page surrounded by a border. |
---|
143 | |
---|
144 | .RS |
---|
145 | enscript -p- textfile | psnup -G -n4 | pslpr |
---|
146 | |
---|
147 | .RE |
---|
148 | .SH FILES |
---|
149 | .TP 2.2i |
---|
150 | XPSLIBDIRX/psnup.pro |
---|
151 | the prologue for |
---|
152 | .I psnup |
---|
153 | files. |
---|
154 | .br |
---|
155 | .SH "SEE ALSO" |
---|
156 | transcript(1), enscript(1), pslpr (1), postscript(7). |
---|
157 | .SH AUTHOR |
---|
158 | Adobe Systems Incorporated |
---|
159 | .SH "NOTES" |
---|
160 | \*(PS is a registered trademark of Adobe Systems Incorporated. |
---|