![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xpr.cat CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv9 / X11 / src / X.V11R1 / clients / xpr|
Return to xpr.cat CVS log | Up to [Research Unix] / researchv9 / X11 / src / X.V11R1 / clients / xpr |
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 ] [ -compact ] [ -output
15: _f_i_l_e_n_a_m_e ] [ -append _f_i_l_e_n_a_m_e ] [ -noff ] [ -split _n ] [
16: -device _d_e_v ] [ _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, LA100, or Apple
21: LaserWriter printer. If no file argument is given, the
22: standard input is used. By default, _x_p_r prints the largest
23: possible representation of the window on the output page.
24: Options allow the user to add headers and trailers, specify
25: margins, adjust the scale and orientation, and append multi-
26: ple window dumps to a single output file. Output is to
27: standard output unless -output 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: and LaserWriter are able to translate each bit in a
35: window pixel map into a grid of a specified size. For
36: example each bit might translate into a 3x3 grid. This
37: would be specified by -scale _3. By default a window is
38: printed with the largest scale that will fit onto the
39: page for the 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: X Version 10 1 14 October 1986
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: -compact
89: Uses simple run-length encoding for compact representa-
90: tion of windows with lots of white pixels.
91:
92: -output _f_i_l_e_n_a_m_e
93: Specifies an output file name. If this option is not
94: specified, standard output is used.
95:
96: -append _f_i_l_e_n_a_m_e
97: Specifies a filename previously produced by _x_p_r to
98: which the window is to be appended.
99:
100: -noff
101: When specified in conjunction with -append, the window
102: will appear on the same page as the previous window.
103:
104: -split _n
105: This option allows the user to split a window onto
106: several pages. This might be necessary for very large
107: windows that would otherwise cause the printer to over-
108: load and print the page in an obscure manner.
109:
110: -device _d_e_v_i_c_e
111: Specifies the device on which the file will be printed.
112: Currently only the LN03 (-device ln03), LA100 (-device
113: la100) and Apple LaserWriter (-device lw or -device ps)
114: are supported.
115:
116: SEE ALSO
117: xwd(1), xdpr(1), xwud(1), X(1)
118:
119: LIMITATIONS
120: The current version of _x_p_r can generally print out on the
121: LN03 most X windows that are not larger than two-thirds
122: of the screen. For example, it will be able to print out a
123: large Emacs window, but it will usually fail when trying
124: to print out the entire screen. The LN03 has memory limi-
125: tations that can cause it to incorrectly print very
126:
127:
128:
129: X Version 10 2 14 October 1986
130:
131:
132:
133:
134:
135:
136: XPR(1) UNIX Programmer's Manual XPR(1)
137:
138:
139:
140: large or complex windows. The two most common
141: errors encountered are ``band too complex'' and ``page
142: memory exceeded.'' In the first case, a window may have a
143: particular six pixel row that contains too many changes
144: (from black to white to black). This will cause the
145: printer to drop part of the line and possibly parts of the
146: rest of the page. The printer will flash the number `1' on
147: its front panel when this problem occurs. A possible solu-
148: tion to this problem is to increase the scale of the pic-
149: ture, or to split the picture onto two or more pages.
150: The second problem, ``page memory exceeded,'' will occur
151: if the picture contains too much black, or if the picture
152: contains complex half-tones such as the background
153: color of a display. When this problem occurs the
154: printer will automatically split the picture into two or
155: more pages. It may flash the number `5' on its from
156: panel. There is no easy solution to this problem. It
157: will probably be necessary to either cut and paste, or
158: rework to application to produce a less complex picture.
159:
160: _X_p_r provides some support for the LA100. However, there
161: are several limitations on its use: The picture will always
162: be printed in portrait mode (this may be changed in the
163: future;) there is no scaling; and the aspect ratio will
164: be slightly off.
165:
166: Support for the the LaserWriter currently cannot handle the
167: -append, -noff or -split options. The -compact option is
168: _o_n_l_y supported for the LaserWriter. It compresses white
169: space but not black space, so it is not useful for reverse-
170: video windows.
171:
172: AUTHOR
173: Copyright 1985, Massachusetts Institute of Technology.
174: LaserWriter support copyright 1986, Marvin Solomon and the
175: University of Wisconsin.
176:
177: Michael R. Gretzinger, MIT Project Athena
178:
179:
180:
181:
182:
183:
184:
185:
186:
187:
188:
189:
190:
191:
192:
193:
194:
195: X Version 10 3 14 October 1986
196:
197:
198:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.