![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xpr.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / X / man|
Return to xpr.1 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / X / man |
1.1 root 1: .TH XPR 1 "27 August 1985" "X Version 10"
2: .SH NAME
3: xpr \- print X window dump
4: .SH SYNOPSIS
5: .B xpr
6: [
7: .B \-scale
8: .I scale
9: ] [
10: .B \-height
11: .I inches
12: ] [
13: .B \-width
14: .I inches
15: ] [
16: .B \-left
17: .I inches
18: ] [
19: .B \-top
20: .I inches
21: ] [
22: .B \-header
23: .I string
24: ] [
25: .B \-trailer
26: .I string
27: ] [
28: .B \-landscape
29: ] [
30: .B \-portrait
31: ] [
32: .B \-output
33: .I filename
34: ] [
35: .B \-append
36: .I filename
37: ] [
38: .B \-noff
39: ] [
40: .B \-split
41: .I n
42: ] [
43: .B \-device
44: .I dev
45: ] [
46: .I filename
47: ]
48: .SH DESCRIPTION
49:
50: .I Xpr
51: takes as input an X window dump file produced by
52: .IR xwd (1)
53: and formats it for output on the LN03 or LA100 printer. If no file
54: argument is given, the standard input is used. By default, \fIxpr\fP
55: prints the largest possible representation of the window on the
56: output page. Options allow the user to add headers and trailers,
57: specify margins, adjust the scale and orientation, and append
58: multiple window dumps to a single output file. Output is to
59: standard output unless
60: .B \-output
61: is specified.
62: .sp 1
63: .ne 8
64: .B Command Options
65: .sp 1
66: .IP "\fB\-scale\fP \fIscale\fP"
67: Affects the size of the window on the page. The LN03 is able to
68: translate each bit in a window pixel map into a grid of a specified size.
69: For example each bit might translate into a 3x3 grid. This would be
70: specified by \fB\-scale\fP \fI3\fP. By default a window is printed
71: with the largest scale that will fit onto the page for the specified
72: orientation.
73: .IP "\fB\-height\fP \fIinches\fP"
74: Specifies the maximum height of the window on the page.
75: .IP "\fB\-width\fP \fIinches\fP"
76: Specifies the maximum width of the window.
77: .IP "\fB\-left\fP \fIinches\fP"
78: Specifies the left margin in inches. Fractions
79: are allowed. By default the window is centered in the page.
80: .IP "\fB\-top\fP \fIinches\fP"
81: Specifies the top margin for the picture in inches. Fractions are
82: allowed.
83: .IP "\fB\-header\fP \fIheader\fP"
84: Specifies a header string to be printed above the window.
85: .IP "\fB\-trailer\fP \fItrailer\fP"
86: Specifies a trailer string to be printed below the window.
87: .IP "\fB\-landscape\fP"
88: Forces the window to printed in landscape mode. By default
89: a window is printed such that its longest side follows the long side of
90: the paper.
91: .IP "\fB\-portrait\fP"
92: Forces the window to be printed in portrait mode. By default
93: a window is printed such that its longest side follows the long side of
94: the paper.
95: .IP "\fB\-output\fP \fIfilename\fP"
96: Specifies an output file name. If this option is not specified, standard
97: output is used.
98: .IP "\fB\-append\fP \fIfilename\fP"
99: Specifies a filename previously produced by \fIxpr\fP to which the window
100: is to be appended.
101: .IP "\fB\-noff\fP"
102: When specified in conjunction with \fB\-append\fP, the window will appear
103: on the same page as the previous window.
104: .IP "\fB\-split\fP \fIn\fP"
105: This option allows the user to split a window onto several pages.
106: This might be necessary for very large windows that would otherwise
107: cause the printer to overload and print the page in an obscure manner.
108: .IP "\fB\-device\fP \fIdevice\fP"
109: Specifies the device on which the file will be printed. Currently only
110: the LN03 and LA100 are supported.
111: .SH SEE ALSO
112: xwd(1), xdpr(1), xwud(1), X(1)
113: .SH LIMITATIONS
114:
115: The current version of \fIxpr\fP can generally print out on the LN03
116: most X windows that are not larger than two-thirds of the screen.
117: For example, it will be able to print out a large Emacs window, but
118: it will usually fail when trying to print out the entire screen. The
119: LN03 has memory limitations that can cause it to incorrectly print
120: very large or complex windows. The two most common errors
121: encountered are ``band too complex'' and ``page memory exceeded.''
122: In the first case, a window may have a particular six pixel row that
123: contains too many changes (from black to white to black). This will
124: cause the printer to drop part of the line and possibly parts of the
125: rest of the page. The printer will flash the number `1' on its front
126: panel when this problem occurs. A possible solution to this problem
127: is to increase the scale of the picture, or to split the picture onto
128: two or more pages. The second problem, ``page memory exceeded,''
129: will occur if the picture contains too much black, or if the picture
130: contains complex half-tones such as the background color of a
131: display. When this problem occurs the printer will automatically
132: split the picture into two or more pages. It may flash the number
133: `5' on its from panel. There is no easy solution to this problem.
134: It will probably be necessary to either cut and paste, or rework to
135: application to produce a less complex picture.
136:
137: \fIXpr\fP provides some support for the LA100. However, there are
138: several limitations on its use: The picture will always be printed in
139: portrait mode (this may be changed in the future;) there is no
140: scaling; and the aspect ratio will be slightly off.
141: .SH AUTHOR
142: .PP
143: Copyright 1985, Massachusetts Institute of Technology
144: .PP
145: Michael R. Gretzinger, MIT Project Athena
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.