10.0;cpscr (copy_screen), revision 1.0, 88/01/21
cpscr (copy_screen) - copy the current display to a file.
usage: cpscr [-inv] pathname
DESCRIPTION
cpscr copies the current screen image, without clearing it, to the file
you specify. Use the prf (print_file) command to print the file.
Use the DM command cpo to copy the screen without creating a new process
window or changing the current transcript pad. cpo invokes the cpscr
command from the DM without creating a pad or window. Thus, press <CMD>
and type
cpo /usr/apollo/bin/cpscr pathname
You may copy small portions of a black and white screen (such as a single
window) with the DM command xi.
By default, black and white screens are copied into a GMF file. Color
screens are copied into a GPR bitmap.
pathname (required)
Specify file to that the screen is copied.
OPTIONS
-inv Invert image. Use this option to store the image in
reverse video. Black screen pixels become white and white
screen pixels become black. Do not used this option with
the -gpr_bitmap option or on color nodes.
-append Appends a black and white screen image to an existing GMF
file. You cannot use this option with the -gpr_bitmap
option or on color nodes.
-gpr_bitmap Use this option to copy a black and white screen into a
GPR bitmap file rather than a GMF file. This option has
no meaning for color nodes since color screens are already
copied into GPR bitmaps.
EXAMPLES
Invert and copy the current screen image to the specified file. Since
the command line is echoed in the shell's process transcript pad prior to
execution, this command will appear in the resulting image.
$ cpscr -inv //us/looky_there
<cmd>
Command: cpo /usr/apollo/bin/cpscr -inv //us/looky_there
Same result as in the previos example, but the cpscr line will not appear
in the plotted output.
SEE ALSO
More information is available. Type
help xi For details about copying small portions of the screen
help prf For details about printing the screen copy file
help cpo For details about the DM command cpo