|
|
1.1 root 1:
2:
3:
4: XPR(1) UNIX Programmer's Manual XPR(1)
5:
6:
7:
8: NAME
9: xpr - print X window dump
10:
11: SYNOPSIS
12: xpr [ -scale _s_c_a_l_e ] [ -height _i_n_c_h_e_s ] [ -width _i_n_c_h_e_s ] [
13: -left _i_n_c_h_e_s ] [ -top _i_n_c_h_e_s ] [ -header _s_t_r_i_n_g ] [ -trailer
14: _s_t_r_i_n_g ] [ -landscape ] [ -portrait ] [ -output _f_i_l_e_n_a_m_e ] [
15: -append _f_i_l_e_n_a_m_e ] [ -noff ] [ -split _n ] [ -device _d_e_v ] [
16: _f_i_l_e_n_a_m_e ]
17:
18: DESCRIPTION
19: _X_p_r takes as input an X window dump file produced by _x_w_d(1)
20: and formats it for output on the LN03 or LA100 printer. If
21: no file argument is given, the standard input is used. By
22: default, _x_p_r prints the largest possible representation of
23: the window on the output page. Options allow the user to
24: add headers and trailers, specify margins, adjust the scale
25: and orientation, and append multiple window dumps to a sin-
26: gle output file. Output is to standard output unless -out-
27: put is specified.
28:
29: Command Options
30:
31:
32: -scale _s_c_a_l_e
33: Affects the size of the window on the page. The LN03
34: is able to translate each bit in a window pixel map
35: into a grid of a specified size. For example each bit
36: might translate into a 3x3 grid. This would be speci-
37: fied by -scale _3. By default a window is printed with
38: the largest scale that will fit onto the page for the
39: specified orientation.
40:
41: -height _i_n_c_h_e_s
42: Specifies the maximum height of the window on the page.
43:
44: -width _i_n_c_h_e_s
45: Specifies the maximum width of the window.
46:
47: -left _i_n_c_h_e_s
48: Specifies the left margin in inches. Fractions are
49: allowed. By default the window is centered in the
50: page.
51:
52: -top _i_n_c_h_e_s
53: Specifies the top margin for the picture in inches.
54: Fractions are allowed.
55:
56: -header _h_e_a_d_e_r
57: Specifies a header string to be printed above the win-
58: dow.
59:
60:
61:
62:
63: Printed 9/15/87 27 August 1985 1
64:
65:
66:
67:
68:
69:
70: XPR(1) UNIX Programmer's Manual XPR(1)
71:
72:
73:
74: -trailer _t_r_a_i_l_e_r
75: Specifies a trailer string to be printed below the win-
76: dow.
77:
78: -landscape
79: Forces the window to printed in landscape mode. By
80: default a window is printed such that its longest side
81: follows the long side of the paper.
82:
83: -portrait
84: Forces the window to be printed in portrait mode. By
85: default a window is printed such that its longest side
86: follows the long side of the paper.
87:
88: -output _f_i_l_e_n_a_m_e
89: Specifies an output file name. If this option is not
90: specified, standard output is used.
91:
92: -append _f_i_l_e_n_a_m_e
93: Specifies a filename previously produced by _x_p_r to
94: which the window is to be appended.
95:
96: -noff
97: When specified in conjunction with -append, the window
98: will appear on the same page as the previous window.
99:
100: -split _n
101: This option allows the user to split a window onto
102: several pages. This might be necessary for very large
103: windows that would otherwise cause the printer to over-
104: load and print the page in an obscure manner.
105:
106: -device _d_e_v_i_c_e
107: Specifies the device on which the file will be printed.
108: Currently only the LN03 and LA100 are supported.
109:
110: SEE ALSO
111: xwd(1), xdpr(1), xwud(1), X(1)
112:
113: LIMITATIONS
114: The current version of _x_p_r can generally print out on the
115: LN03 most X windows that are not larger than two-thirds
116: of the screen. For example, it will be able to print out a
117: large Emacs window, but it will usually fail when trying
118: to print out the entire screen. The LN03 has memory limi-
119: tations that can cause it to incorrectly print very
120: large or complex windows. The two most common
121: errors encountered are ``band too complex'' and ``page
122: memory exceeded.'' In the first case, a window may have a
123: particular six pixel row that contains too many changes
124: (from black to white to black). This will cause the
125: printer to drop part of the line and possibly parts of the
126:
127:
128:
129: Printed 9/15/87 27 August 1985 2
130:
131:
132:
133:
134:
135:
136: XPR(1) UNIX Programmer's Manual XPR(1)
137:
138:
139:
140: rest of the page. The printer will flash the number `1' on
141: its front panel when this problem occurs. A possible solu-
142: tion to this problem is to increase the scale of the pic-
143: ture, or to split the picture onto two or more pages.
144: The second problem, ``page memory exceeded,'' will occur
145: if the picture contains too much black, or if the picture
146: contains complex half-tones such as the background
147: color of a display. When this problem occurs the
148: printer will automatically split the picture into two or
149: more pages. It may flash the number `5' on its from
150: panel. There is no easy solution to this problem. It
151: will probably be necessary to either cut and paste, or
152: rework to application to produce a less complex picture.
153:
154: _X_p_r provides some support for the LA100. However, there
155: are several limitations on its use: The picture will always
156: be printed in portrait mode (this may be changed in the
157: future;) there is no scaling; and the aspect ratio will
158: be slightly off.
159:
160: AUTHOR
161: Copyright 1985, Massachusetts Institute of Technology
162:
163: Michael R. Gretzinger, MIT Project Athena
164:
165:
166:
167:
168:
169:
170:
171:
172:
173:
174:
175:
176:
177:
178:
179:
180:
181:
182:
183:
184:
185:
186:
187:
188:
189:
190:
191:
192:
193:
194:
195: Printed 9/15/87 27 August 1985 3
196:
197:
198:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.