*** UNIX MANUAL PAGE BROWSER ***

dxprint(1X) dxprint(1X) NAME dxprint - Capture and print screen image. SYNOPSIS dxprint [options] [file] OPTIONS Usage Diagrams dxprint -X dxprint [-p] [-b|G] [-f] [-r] [geom*] [-t seconds] [-P queue] \ [-P queue] [file] dxprint [-p] -c [-f] [geom*] [-t seconds] [-P queue] [file] dxprint -D [-b|G] [-r] [geom*] [-t seconds] [-P queue] [file] dxprint -D -c [geom*] [-t seconds] [-P queue] [file] dxprint -s [-b|G] [-a] [-r] [geom*] [-t seconds] [-T n] \ [-P queue] [file] dxprint -s -c [geom*] [-t seconds] [-T n] [-P queue] [file] *geom is -x n -y n -h n -w n Consult the usage diagrams, above, to determine what combinations of options are permissible. Options Specifying GUI and Time Delay Brings up the dxprint graphical user interface from which you can in- voke help for more information. Causes a wait of integer seconds be- fore the actual capture occurs, so that the screen arrangement can be changed prior to the capture. If deleted, no delay will occur. Options Specifying Area to Capture Specify all four of the following options for a partial capture. Spec- ify none of the options for a full screen capture. There are no default values for these options. Defines the upper left corner of the capture region in pixel units from the left edge of the screen active area. Defines the upper left corner of the capture region in pixel units from the top edge of the screen active area. Defines the lower right corner of the capture region in pixel units from the left edge of the capture region (in other words, its width). Defines the lower right corner of the capture region in pixel units from the top edge of the capture re- gion (in other words, its height). Options Specifying Output File Format If no output-specifying options are used, the default is -pf (Post- Script, rotated/scaled to fit page). PostScript is the only output format that is by default sent to the standard output. DDIF and Sixel formats are binary and must be saved to a file, with a command such as: dxprint -s file Creates the output file in Sixel format. A Sixel file can be viewed in a DECterm by using the cat command, or it can be printed on most types of printers from Digital Equipment Corporation. Default. Creates the output file in PostScript format. Creates the output file in DDIF (CDA) format. A DDIF file can be viewed with the CDA viewer (/usr/bin/X11/dxvdoc) and edited with the DECwindows bitmap editor (/usr/bin/X11/dxpaint). The following three switches modify the output file when used according to the usage diagrams above. Creates a (Sixel only) output file with a horizontal doubling of the printable output. This is useful to elimi- nate a "squeezed" appearance of the screen image when printed on print- ers that have a greater horizontal resolution than vertical resolution, such as the Digital LA50. Creates an output file with a reversal of light and dark. This option is useful to save printer ink or toner when printing screen images that are mostly dark. Creates an output file that is either printed at a 90 degree angle, or uniformly reduced in size, or both, so that it will fit entirely within an A-size printed page. This option is implied when PostScript is chosen by default (by omitting the -s, -p, and -D options). For Sixel captures, specifies the Sixel output device. Integer represents a printer from the follow- ing table: l l. VT terminal or DECterm 2 LA50 12 LA75 13 LA100 14 Laser printer (LN03, LPS20, etc.) 15 LCG01 19 LJ250 (256 color mode) 20 LA210 21 LJ250 (8 color mode) 24 The default for black and white (-b) and greyscale (-G) screen captures is the LN03. The default for color captures (-c) is the LJ250. Options Specifying Output Color Default. Creates a black and white capture file. This rendering is supported by all workstations and printers. It will create a high con- trast printed output - screen areas darker than 50% gray will appear black, and lighter screen areas will appear white. Creates a gray- scale capture file. This rendering is supported by all printers, but only by color or gray-scale workstations. A color screen image will be represented in the file by suitable shades of gray, but there may be adjacent regions of different colors that coincidentally have the same gray value when printed and thus will "blend into" each other. Creates a color capture file. This color rendering is supported by all print- ers but only on color workstations (with any number of color planes). Printing it on a black and white printer will give varying results de- pending on the printer. Sixel output is optimized for a Digital LJ250 color printer. DESCRIPTION The dxprint (Print Screen) program allows you to capture the screen im- age in printable form. The available output formats are PostScript, Sixel, and DDIF (Digital Document Interchange Format). An optional time delay gives you time to rearrange the screen to iconify or restack windows, or to give focus to the window with the color map to be used for the capture. Output is sent to the standard output unless file is supplied. The -X option displays the dxprint Graphical User Interface (GUI). This reference page describes the dxprint command line interface. Use the GUI help facility for help with the dxprint GUI. EXAMPLES This example captures a reversed-contrast full-screen PostScript cap- ture in the file mysnapshot.ps (in the current working directory) after a one second delay. dxprint -p -r -t mysnapshot.ps This example cap- tures a black and white PostScript image of the area bounded by (100,100) and (300,150) to standard output. dxprint -x100 -y100 -w200 -h50 SEE ALSO cdoc(1), lpr(1), dxvdoc(1X), dxpaint(1X), CDA(4), DDIF(4), lpd(8) dxprint(1X)