1.0;cpscr (copy_screen), revision 1.0, 87/03/20
CPSCR (COPY_SCREEN) -- Copy the current display to a file.
usage:  CPSCR pathname [-INV]


FORMAT

  CPSCR pathname [-INV] [-APPEND] [-GPR[_BITMAP]]


  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 Display Manager 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 Display Manager without creating a  pad  or  window.    Thus,
  press <CMD> then type:

    CPO /COM/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.


ARGUMENTS

  pathname
  (required)         Specify file to which 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.   This switch cannot be used
                     with the -gpr_bitmap switch or on color nodes.

  -APPEND            Appends a black and white screen image to an  existing  GMF
                     file.    This  switch  cannot  be used with the -gpr_bitmap
                     switch 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

  1. $ cpscr //us/looky_there -inv   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.

  2. <CMD>
     Command: cpo /com/cpscr //us/looky_there -inv

                                     Same result as in example 1,
                                      but the CPSCR line will not
                                      appear in the plotted output.


RELATED TOPICS

  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.