SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
NAME
screencopy - send a copy of the screen or window to a
printer
SYNOPSIS
screencopy [ -X ] [ -S ] [ -root ] [ -Ffilename ] [
print_options ] [ queue_options ] [ -h ]
DESCRIPTION
The screencopy command copies the screen, or a portion of
it, to a color hard copy device through the X Window System
environment (versions X10.4 or X11.2), or the Smalltalk
environment.
In the X environment the screencopy command can be executed
from the command line or put in a menu and executed by
selecting it with the mouse.
Default options can be supplied to the screencopy command by
placing them in the .Xdefaults file in the user's home
directory. Menu selections can be defined by entries in the
.uwmrc file in the user's home directory.
In the Smalltalk environment the System Background Menu is
used to dump the screen to a file. This menu is available
when the cursor is over the gray background (not in a
window) and the middle mouse button is pressed. The copy
display menu choice copies the screen bitmap to a file; the
user is prompted for the file name. The user then invokes
the screencopy command with the -S option, followed by the
-F option with the name of the file containing the screen
bitmap. (See the Tektronix Smalltalk User's Manual for more
information on the Smalltalk environment.)
The output data is sent to the spooling system for printing.
The spooling system can print the screencopy on a local
printer or send it across the network to a remote printer.
The various terminals that generate the data do not exactly
match the colors of the printers. The resulting colors
approximate the colors on the screen.
Also, screencopy data lacks information about the physical
size of the picture displayed on the terminal screen. Window
copies are usually larger than the window on the screen,
while full screen copies are smaller than the full screen.
OPTIONS
-X Specifies the data file is in an X format.
-S Specifies the data file is in a Smalltalk format.
Printed 4/6/89 1
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
-root
This parameter specifies that the root window be dumped
if the -F option is not used. It is valid only for screen
copies in the X11 window environment. Using this option
in the X10 window environment prints an error message.
-F filename
Use the file filename as the source for input. If the -F
parameter is not specified, a dump of a window or full
screen is done first; screencopy then makes a hard copy.
-h Generates a help message.
Print Options
These are the printer options supplied to the x_grf
(x_grf(1)) and st_grf (st_grf(1)) commands. They specify
imaging and processing options for printing the screen copy
and are different depending on the color printer. The 4692,
4693D, and 4696 are supported Tektronix color printers and
specified by the -o option. The default color printer is
the 4693D.
Common Print Options
-o device
Overrides the default color printer. Valid output
devices are the Tektronix color printers 4693d, 4692, and
4696.
-i device
Overrides the default input device for the screen dump.
The default for an X window dump is determined by
parameters in the X dump header. For a Smalltalk dump it
is determined by the grf_header file
(grf_header.469X(5)). Valid input devices are the
following Tektronix color terminals: 4315, 4316, 4317,
4224, 4225, 4235, 4236, 4237, 4320, 4324, 4325, 4330,
4335, 4336, or 4337.
This option tags the image data with the device name it
came from.
-k colordefinitionsfile
Specifies an alternate set of color definitions. This
file contains an entry for each color defined, consisting
of the RGB values separated by tabs or spaces, and a
character string representing a color name. If a color
name consists of more than one word, use the underscore
(_) character as a word separator. For example, the
entry for orange_red in a color definitions file would be
255 127 0 orange_red.
Printed 4/6/89 2
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
Note: The x_grf(1) utility uses the file rgb.txt as the
default colordefinitionsfile. For further information,
see x_grf(1).
-O orientation
Sets the image orientation on the media. Valid options
are landscape, portrait_upper, portrait_center,
portrait_lower, or default.
The default for this option is default, and depending on
the color printer, is usually landscape orientation.
Processing Print Options
-b border_color
Specifies the border color, or no border, around the
image. Valid options are red, green, blue, cyan,
magenta, yellow, white, black, or none.
Other color definitions can be used if a file containing
the new colors is specified using the -k option. If a
color name consists of more than one word, use the
underscore (_) character rather than a space as a word
separator.
If this option is not specified, the default is none.
-B local|none
Specifies local black correction by processing. If this
option is not specified the default is none, which turns
off any black correction.
-C local|none
Specifies color correction by processing. If this option
is not specified, the default is none, which turns off
any color correction.
-D [rotate:]matrix_size[:local|:remote]
Specifies the type of built-in dithering by processing
using either local or remote dithering matrices. The
local option specifies the dithering matrices come from
the local host. The remote option specifies they come
from the remote host. If spooling to a remote host and
local is specified, the dithering matrices come from the
local host.
Ordered dithering produces a full palette of colors using
the colors (cyan, magenta, yellow, and black) of the
printer. The dither matrix_size parameter can be 2, 4,
8, or 16 which corresponds to a 2 by 2 matrix, 4 by 4
matrix, 8 by 8 matrix, or 16 by 16 matrix. The various
sizes allow for the tradeoff between the truer colors
Printed 4/6/89 3
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
obtained with a larger dither size and the finer detail
of a smaller dither size. Dither patterns can also be
rotated 90 degrees with -D rotate:matrix_size.
-d dither_file
Specifies an alternate dithering matrix file; use -D to
specify the matrix size and rotation.
The default for dithering is off.
Note: When dithering with processing, take into account
any dithering to be done by the color printers
themselves. This option generally should not be used
when sending hard copy to the 4693D color printer, which
has its own dithering algorithms.
-G local|remote|none
Enables or disables built-in gamma correction using
either local or remote intensity values. Gamma
correction is designed to match the intensity of the
screen to the color printer.
The local option specifies the gamma intensity values
come from the local host. The remote option specifies
they come from the remote host. If spooling to a remote
host and local is specified, the gamma intensity values
come from the local host.
The default for this option depends on the color printer,
but in most cases is none.
-g gamma_file
Specifies an alternate gamma correction data file used by
processing; use with -G local.
-I local|color1=color2|none
Specifies color pixel inversion, excluding the image
border, by processing.
The local option specifies black and white pixel
inversion.
The color1=color2 option specifies inversion of any two
colors. Valid colors are: red, green, blue, cyan,
magenta, yellow, white and black.
Additional colors can be defined in a file which is
specified with the -k option. If a color name consists of
more than one word, use the underscore (_) character as a
word separator.
The none option specifies no pixel inversion. The
Printed 4/6/89 4
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
default depends on the printer, but in most cases is
none.
4692 Color Printer Options
-I invert|default
Specifies black and white pixel inversion by the 4692
color printer. The default option specifies no
inversion.
-Q quality
Sets the image quality used by the 4692 color printer.
Valid options are variable, high, and highest.
The variable option allows the addressability to vary
from 154 dots/inch (158.5 dots/inch for metric copiers)
to 128 dots/inch. The high and highest options both set
the addressability to 154 dots/inch for A-size media.
-r passes
Specifies the number of repaint passes done by the 4692
printer. The value passes can range from 1 to 4. 1 is
the default. This option is used to make denser colors
on transparencies.
4693D Color Printer Options
-C 4693d|tek_terminal|default
Specifies the type of color correction done by the 4693D
color printer.
The 4693d option specifies color correction that
compensates for the imperfections of the printer;
tek_terminal matches the colors printed on the paper to
those on the terminal screen. The default option uses
the front panel value set on the 4693D color printer.
-G 2.2|2.4|2.6|2.8|default
Specifies the amount of video gamma correction on the
incoming colors to the printer. Attempts to match the
intensity of the printed colors to the intensity of the
screen colors. The default option uses the front panel
value set on the 4693D color printer.
-e eight_colors|full_color_1|full_color_2|
black_white|gray_shading|default
Specifies color rendering on the 4693D color printer.
The eight_colors option uses the closest match of the
eight primary colors: red, green, blue, cyan, magenta,
yellow, black and white.
Printed 4/6/89 5
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
The full_color_1 and full_color_2 options both use
dithering with 256 levels of intensity per primary;
full_color_2 generates true black with black ink rather
than a composite black using cyan, magenta, and yellow
inks.
The black_white option renders the closest match of black
or white; gray_shading renders the closest match of 256
levels of gray; default uses the front panel value set
on the 4693D color printer.
Any of these options can give unexpected results when
combined with dithering by processing.
-I invert|index1:index2|default
Specifies inversion of color pixels by the 4693D color
printer.
The invert option specifies inversion of saturated black
and saturated white pixels.
The index1:index2 option inverts any two color indices
found in the color map. The GRF image file must contain a
color map for this option to be valid.
The default option uses the front panel value set on the
4693D color printer.
-s interpolation|replication|default|none
Sizes the image. The interpolation option interpolates
the image to maximum size on the media; replication
enlarges the image the maximum integral number of times
allowed by the printer's addressability (best for text
and line drawings); none prints the image with no change
to the number of pixels printed; default uses the front
panel value set on the 4693D color printer.
4696 Color Printer Options
-s replication|default|none
Sizes the image. The replication option replicates the
image to a maximum factor of 8 times on the media; none
prints the image with no change to its size; default is
an alias for none on the 4696 color printer.
Queue Options
These are queuing options supplied to the tcpr command. (See
tcpr(1mdqs).):
-a atime
This option starts the job after atime. See
Printed 4/6/89 6
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
getdate(5mdqs) for a full description of time
specifications. The most useful time specification is
hour:minute [meridian]. If meridian -- am or pm -- is
not specified, a 24-hour clock is used.
-c count
Prints count copies of the specified files.
-f form
Prints the files on the specified form. The default form
is specified in /etc/qconf. The form must match an entry
in the tcprforms file for the color printer. For further
information on forms, see tcprforms(5).
-m Sends a mail message to the user via mail(1mh) when
printing is completed.
-p priority
Overrides the default request priority. The priority is
in the range 0-10; 5 is the default. Only the superuser,
the MDQS user or a member of the systems group can
request a priority of 0.
-q queue
Sends a request to a queue other than the default.
Queuing a request to other than a print queue gives
unpredictable results. The default print queue is
specified in /etc/qconf.
-R ruser
Specifies another user on the remote host for rsh
privileges. When a request is made to print on a remote
host, MDQS requires the requesting local user name to
exist on the remote host with rsh(1n) privileges.
-u useraddr
Overrides the default notification address with the
address useraddr. This address should be a valid address
to your mail system. The default notification address is
the name of the user on the current host.
EXAMPLES
This example specifies dumps to the window and prints the
data on the default printer in portrait center format:
screencopy -O portrait_center
This example prints the data from the file piechart.dat in
landscape orientation to the default printer; screencopy
assumes the data in piechart.dat is from an X window dump:
Printed 4/6/89 7
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
screencopy -F piechart.dat
This example does the same as the previous, but assumes the
data is from a Smalltalk window dump:
screencopy -S -F piechart.dat
This example overrides the default printer and queue to
direct the window dump to a 4692 color printer, with 2
repaint passes and 5 copies made:
screencopy -o 4692 -q tcpr92 -r 2 -c 5
This example shows a possible default setting for the
screencopy command in the user's .Xdefault file for use in
the X environment. It specifies the screen copy to be in
portrait upper format with no change in image size. It
assumes the default printer is a 4693D.
screencopy.defaults: -O portrait_upper -s none
This example shows a possible window operations menu entry
in the user's .uwmrc file for the screencopy command in the
X environment:
f.menu= :root: left down : "WOps"
menu = "WOps" (Aquamarine:Black:White:Orange) {
Refresh: !"xrefresh&"
Move: f.move
Resize: f.resize
Hardcopy window: !"screencopy&"
}
FILES
~/.Xdefaults
Personalize the actions of screencopy
~/.uwmrc Add menu selection for screencopy
VARIABLES
PATH The user's execution path.
HOME The user's home directory.
RETURN VALUE
[NO_ERRS] Command completed without error.
[USAGE] Incorrect command line syntax. Execution
terminated.
[NP_WARN] An error warranting a warning message
Printed 4/6/89 8
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1)
occurred. Execution continues.
[NP_ERR] An error occurred that was not a system
error. Execution terminated.
[P_ERR] A system error occurred. Execution
terminated. See intro(2) for more
information on system errors.
SEE ALSO
lpr(1mdqs), processing(1), st_grf(1), x_grf(1), uwm(1x),
xwd(1px), tcpr(1mdqs), and grf(5).
REFERENCES
For more information, consult the Users Manual for your
system.
Printed 4/6/89 9
%%index%%
na:384,118;
sy:502,487;
de:989,2906;
op:3895,229;4580,4160;9196,5072;14724,3895;19075,4796;24327,4852;29635,2167;
ex:31802,590;32848,1409;
fi:34257,406;
va:34663,196;
rv:34859,329;35644,336;
se:35980,290;
re:36270,243;
%%index%%000000000252