dxprint(1X)dxprint(1X)NAMEdxprint - Capture and print screen image.
SYNOPSISdxprint [ flags ] [ file ]
DESCRIPTION
The dxprint (Print Screen) program allows you to capture the screen
image 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.
FLAGS
Usage Diagrams
dxprint-Xdxprint [-p] [-b|G] [-f] [-r] [geom*] [-t seconds] [-P
queue] \
[-P queue] [file] dxprint [-p] -c [-f] [geom*] [-t sec‐
onds] [-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
flags are permissible.
Flags Specifying GUI and Time Delay
Brings up the dxprint graphical user interface from which you can
invoke help for more information. Causes a wait of integer seconds
before the actual capture occurs, so that the screen arrangement can be
changed prior to the capture. If deleted, no delay will occur.
Flags 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 region (in other words, its height).
Flags Specifying Output File Format
If no output-specifying flags are used, the default is -pf (PostScript,
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 flags). For Sixel captures, specifies the
Sixel output device. Integer represents a printer from the following
table:
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.
Flags 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
depending on the printer. Sixel output is optimized for a Digital LJ250
color printer.
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 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
RELATED INFORMATIONcdoc(1), lpr(1), dxvdoc(1X), dxpaint(1X), CDA(4), DDIF(4), lpd(8)dxprint(1X)