 |
Click this button to go to the index for this section. |
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
-X Brings up the dxprint graphical user interface from which you can
invoke help for more information.
-t integer
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.
Options Specifying Area to Capture
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 integer
Defines the upper left corner of the capture region in pixel units from
the left edge of the screen active area.
-y integer
Defines the upper left corner of the capture region in pixel units from
the top edge of the screen active area.
-w integer
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).
-h integer
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).
Options Specifying Output File Format
If no output-specifying options 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
-s 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.
-p Default. Creates the output file in PostScript format.
-D 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.
-a Creates 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.
-r 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.
-f 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).
-T integer
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.
Options Specifying Output Color
-b Default. Creates a black and white capture file. This 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.
-G 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.
-c Creates a color capture file. This color rendering is supported by all
printers 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.
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.
EXAMPLES
1. This example captures a reversed-contrast full-screen PostScript
capture in the file mysnapshot.ps (in the current working directory)
after a one second delay.
dxprint -p -r -t mysnapshot.ps
2. 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
SEE ALSO
cdoc(1), lpr(1), dxvdoc(1X), dxpaint(1X), CDA(4), DDIF(4), lpd(8)