XPR(1X11) COMMAND REFERENCE XPR(1X11) NAME xpr - print an X window dump SYNOPSIS xpr [ -scale scale ] [ -height inches ] [ -width inches ] [ -left inches ] [ -top inches ] [ -header string ] [ -trailer string ] [ -landscape ] [ -plane ] [ -portrait ] [ -rv ] [ -compact ] [ -output filename ] [ -append filename ] [ -noff ] [ -split n ] [ -device dev ] [ filename ] This is a user-contributed client. DESCRIPTION This program takes as input a window dump file produced by xwd(1) and formats it for output on the LN03, LA100, PostScript printers, or IBM PP3812 page printer. If no file argument is given, the standard input is used. By default, xpr prints the largest possible representation of the window on the output page. Options allow the user to add headers and trailers, specify margins, adjust the scale and orientation, and append multiple window dumps to a single output file. Output is to standard output unless -output is specified. OPTIONS -scale scale Affects the size of the window on the page. The LN03 and PostScript printers are able to translate each bit in a window pixel map into a grid of a specified size. For example each bit might translate into a 3x3 grid. This would be specified by -scale 3. By default a window is printed with the largest scale that will fit onto the page for the specified orientation. -height inches Specifies the maximum height of the window on the page. -width inches Specifies the maximum width of the window. -left inches Specifies the left margin in inches. Fractions are allowed. By default the window is centered in the page. -top inches Specifies the top margin for the picture in inches. Fractions are allowed. -header header Specifies a header string to be printed Printed 3/22/89 1
XPR(1X11) COMMAND REFERENCE XPR(1X11) above the window. -trailer trailer Specifies a trailer string to be printed below the window. -landscape Forces the window to printed in landscape mode. By default a window is printed such that its longest side follows the long side of the paper. -plane Specifies which bit plane to use in a Z format image. The default is bit plane zero, which is the least significant bit plane. -portrait Forces the window to be printed in portrait mode. By default a window is printed such that its longest side follows the long side of the paper. -rv Forces the window to be printed in reverse video. -compact Uses simple run-length encoding for compact representation of windows with lots of white pixels. -output filename Specifies an output file name. If this option is not specified, standard output is used. -append filename Specifies a filename previously produced by xpr to which the window is to be appended. -noff When specified in conjunction with -append, the window will appear on the same page as the previous window. -split n This option allows the user to split a window onto several pages. This might be necessary for very large windows that would otherwise cause the printer to overload and print the page in an obscure manner. -device device Specifies the device on which the file will be printed. Currently only the LN03 (-device ln03), LA100 (-device la100), PostScript printers (-device ps) and IBM PP3812 (-device pp) are supported. LaserWriter (-device lw) is Printed 3/22/89 2
XPR(1X11) COMMAND REFERENCE XPR(1X11) equivalent to -device ps and is provided only for backwards compatibility. CAVEATS The current version of xpr can generally print out on the LN03 most X windows that are not larger than two-thirds of the screen. For example, it will be able to print out a large Emacs window, but it will usually fail when trying to print out the entire screen. The LN03 has memory limitations that can cause it to incorrectly print very large or complex windows. The two most common errors encountered are ``band too complex'' and ``page memory exceeded.'' In the first case, a window may have a particular six pixel row that contains too many changes (from black to white to black). This will cause the printer to drop part of the line and possibly parts of the rest of the page. The printer will flash the number `1' on its front panel when this problem occurs. A possible solution to this problem is to increase the scale of the picture, or to split the picture onto two or more pages. The second problem, ``page memory exceeded,'' will occur if the picture contains too much black, or if the picture contains complex half-tones such as the background color of a display. When this problem occurs the printer will automatically split the picture into two or more pages. It may flash the number `5' on its from panel. There is no easy solution to this problem. It will probably be necessary to either cut and paste, or to rework the application to produce a less complex picture. The xpr command provides some support for the LA100. However, there are several limitations on its use: the picture will always be printed in portrait mode, there is no scaling, and the aspect ratio will be slightly off. Support for PostScript output currently cannot handle the -append, -noff or -split options. The -compact option is only supported for PostScript output. It compresses white space but not black space, so it is not useful for reverse-video windows. SEE ALSO X(1x11), xwd(1x11), and xwud(1x11). AUTHORS Michael R. Gretzinger, MIT Project Athena, Jose Capo, MIT Project Athena (PP3812 support), Marvin Solomon (University of Wisconsin). Printed 3/22/89 3
%%index%% na:288,80; sy:368,1724; de:2092,815; op:2907,1759;5026,3810;9196,216; ca:9412,2442; se:11854,388; %%index%%000000000131