dxprint(1X) — Commands
Digital
NAME
dxprint − capture and print screen image
SYNOPSIS
dxprint [ options ] [ file ]
DESCRIPTION
The dxprint program allows you to capture the screen image in printable form.
The available output formats are PostScript, Sixel and DDIF.
An optional time delay gives you time to rearrange the screen in order to iconify or restack windows, as well as to "touch" the window with the color map desired for the capture.
All output is sent to the standard output unless file is supplied.
FLAGS
-t integerCauses a wait of integer seconds before the actual capture occurs, so that the screen contents can be changed to suit the user. If deleted, no delay will occur.
Specify all four of the following options for a partial capture. Specify none of the options for a full screen capture. There are no default values for these options.
-x integerDefines the upper left corner of the capture region in pixel units from the left edge of the screen active area.
-y integerDefines the upper left corner of the capture region in pixel units from the top edge of the screen active area.
-w integerDefines the lower right corner of the capture region in pixel units from the left edge of the capture region (in other words, its width).
-h integerDefines the lower right corner of the capture region in pixel units from the top edge of the capture region (in other words, its height).
Only one of the following three format options may be specified in one dxprint command. If none is specified, -pf is implied (PostScript, rotated/scaled to fit page).
-sCreates the output file in Sixel format. Only the -a, -r and -f options, plus one of the -b, -g or -c options are allowable.
-pDefault. Creates the output file in PostScript format. Only the -r and -f options, plus either of the -b or -g options are allowable.
-dCreates the output file in DDIF (CDA) format. Only the -r option, plus one of the -b, -g or -c options are allowable.
The following three options may be specified in any combination, provided that they are listed as allowable by the selected output format. If any of these options is unspecified, the action will not be performed.
-aCreates a (Sixel only) output file with a horizontal doubling of the printable output. This is useful to eliminate a "squeezed" appearance of the screen image when printed on printers that have a greater horizontal resolution than vertical resolution, such as the DIGITAL LA50.
-rCreates an output file with a reversal of light and dark. This cannot be used with the -c (color) option. This option is useful to save printer ink or toner when printing screen images that are mostly dark.
-fCreates an output file that is either printed at a ninety degree angle, or uniformly reduced in size, or both, so that it will fit entirely within an A-size printed page. This option is available only with PostScript format. It is implied when PostScript is chosen by default (omitting the -p switch).
Only one of the following three options may be specified. Some may not be available for the chosen output format. The default color rendering is black-and-white.
-bDefault. Creates a black-and-white capture file. This color rendering is supported by all workstations and printers. It will create a high contrast printed output -- screen areas darker than 50% gray will appear black, and lighter screen areas will appear white.
-gCreates a gray-scale capture file. This color 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 color that coincidentally have the same gray value when printed and thus will "blend into" each other.
-cCreates a color capture file. This color rendering is supported by all printers (subject to the restriction on PostScript noted below) but only on color workstations (with any number of color planes). Printing it on a black-and-white printer will give varying results depending on the printer. Sixel output is optimized for a DIGITAL LJ250 color printer.
RESTRICTIONS
Color PostScript is not yet available directly. Use the DDIF format and DDIF-to-Postscript conversion (see cdoc(1) ) to obtain color PostScript output.
EXAMPLES
The first example captures a reversed-contrast full-screen PostScript capture in the file foobar.post (in the cwd) after a 10 second delay.
dxprint -p -r -t 10 foobar.post
The second example captures a black-and-white PostScript image of the area bounded by (100,100) and (300,150) to standard output.
dxprint -x100 -y100 -w200 -h50
ERRORS
None at the present time. Errors in underlying components cause the command to terminate and return to the shell.