SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) NAME screencopy - send a copy of the screen or window to a printer SYNOPSIS screencopy [ -X ] [ -S ] [ -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 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 5/19/88 1
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) -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. PrintOptions These are the printer options supplied to the xgrf (x_grf(1)) and stgrf (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 orangered. Note: The x_grf(1) utility uses the file /usr/lib/rgb.txt as the default colordefinitionsfile. -O orientation Printed 5/19/88 2
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) Sets the image orientation on the media. Valid options are landscape, portraitupper, portraitcenter, portraitlower, 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 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 Printed 5/19/88 3
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) 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 default depends on the printer, but in most cases is none. 4692 Color Printer Options Printed 5/19/88 4
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) -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|tekterminal|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; tekterminal 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 eightcolors|fullcolor1|fullcolor2| blackwhite|grayshading|default Specifies color rendering on the 4693D color printer. The eightcolors option uses the closest match of the eight primary colors: red, green, blue, cyan, magenta, yellow, black and white. The fullcolor1 and fullcolor2 options both use dithering with 256 levels of intensity per primary; fullcolor2 generates true black with black ink rather than a composite black using cyan, magenta, and yellow inks. Printed 5/19/88 5
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) The blackwhite option renders the closest match of black or white; grayshading 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. QueueOptions These are queuing options supplied to the tcpr command. (See tcpr(5mdqs).): -a atime This option starts the job after atime. See 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. Printed 5/19/88 6
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) -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: screencopy -F piechart.dat This example does the same as the previous, but assumes the data is from a Smalltalk window dump: Printed 5/19/88 7
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) 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(1). ~/.uwmrc Add menu selection for screencopy(1). 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 occurred. Execution continues. [NP_ERR] An error occurred that was not a system error. Execution terminated. Printed 5/19/88 8
SCREENCOPY(1) COMMAND REFERENCE SCREENCOPY(1) [P_ERR] A system error occurred. Execution terminated. See intro(2) for more information on system errors. SEE ALSO lpr(1), processing(1), st_grf(1), x_grf(1), uwm(1), xwd(1), tcpr(1mdqs), and grf(5). REFERENCES For more information, consult the Users Manual for your system. Printed 5/19/88 9
%%index%% na:384,118; sy:502,427; de:929,2880; op:3809,230;4495,4165;9116,5132;14704,3962;19122,5072;24650,4594;29700,1901; ex:31601,737;32794,1267; fi:34061,285; va:34346,196; rv:34542,492;35490,173; se:35663,269; re:35932,248; %%index%%000000000252