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