% @(#)copy_grap.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:24
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_grap.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/GRAPHICS
%.PURPOSE    On-line help file for the command: COPY/GRAPHICS
%.VERSION    1.0 910308 RHW creation
%.VERSION    1.1 910308 RHW Improved acc. to verification form
%.VERSION    1.1 911216 RHW implemented 
%----------------------------------------------------------------
\se
SECTION./GRAP
\es\co
COPY/GRAPHICS 			            			16-Dec-1991 RHW
\oc\su
COPY/GRAPHICS [device] [plotfile]
	copy the existing plot file to the graphic device
\us\pu
Purpose:      
              Copy the existing plot file to the specified graphic device.
\up\sub
Subject:      
              Hardcopy, graphics
\bus\sy
Syntax:       
              COPY/GRAPHICS [device] [plotfile]
\ys\pa
              device  =  plot device; Possible choices can be:\\
                         T[ERMINAL]  the user graphics terminal (default); in 
                                     case of a workstation graphics window 0;\\
                         D[ISPLAY]   the Deanza display or, for workstations,
                                     image window 0; \\                    
                         G[WINDOW,n] graphics window n (default 0); \\
                         D[WINDOW,n] image window n (default 0); \\
                         one of the HARDCOPY devices (see below);\\
                         POSTSCRIPT  generic postscript device;\\
                         NULL        the null device; in this case a plot file
                                     will be created. Handy if you have no
                                     graphic display capabilities availlable.\\
                         default is the device that has been assign with
                         ASSIGN/GRAPHICS
\ap\pa
              plotfile = MIDAS plotfile (with extension .plt) to be routed.
                         Default is plot currently stored in the system; its
                         name can be found with the command SHOW/GRAPHICS
\ap\no
Note:         
              Hardcopy devices should be specified by the system device names.
              For a number of devices default (MIDAS) names have been 
              implemented. A complete overview of the available devices and 
              their names can be obtained with the command HELP [PRINTERS].
\\
              All postscript printers and the device POSTSCRIPT offer the 
              possibility to print in portrait or in landscape mode. In order 
              to get the desired format one has to extend the printer name 
              with ``.l'' for landscape or ``.p'' for portrait mode. Default 
              (no extension given) is landscape mode.
\\
              The scales of a plot may change if a plot is sent to a plot
              device other than the original one (pre-specified by ASSIGN/GRAP).
              In general the axis ratio of the frame will have changed, and
              hence a square frame WILL NOT BE A SQUARE FRAME ANYMORE if
              you use COPY/GRAPHICS to dump your plot on another device.
              This principle also applies in you dump a plot, originally 
              written in portrait mode, in landscape mode, or vice versa. 
\on\see
See also:     
              ASSIGN/GRAPHICS, SHOW/GRAPHICS, HELP [PRINTERS]
\ees\exs
Examples:
\ex
              COPY/GRAP LASER
              Copy current plot file (SHOW/GRAPH) to the device LASER. The 
              plot will come in landscape orientation (which is the default). 
\xe\ex
\\{tt
              ASSIGN/GRAPHICS ps4ipg1.p NOSPOOL
              PLOT/TABLE TEST \#1 \#2 20,10
              OVERPLOT/TABLE TEST \#1 \#3
              COPY/GRAP ps4ipg1.p
\\}
              Assign the laser printer ps4ipg1.p to receive the plot. Here the
              ESO system device name is used. Plot files will now be created 
              but not be spooled to the device ps4ipg1. Next, plot column 1 
              versus 2 of table TEST and overplot column 1 versus column 3.\\
              Finally, the plot is sent to ps4ipg1 and will come in portrait 
              mode.
\xe\ex
\\{\tt
              ASSIGN/GRAPHICS POSTSCRIPT
              PLOT/TABLE TEST \#1 \#2 20,10
              COPY/GRAPHICS LASER
\\}
              Assign POSTSCRIPT as the output "device". Next, plot column 1 
              versus column 2 of the table TEST. A file postscript.ps will
              be created and will contain the graphics. Finally, to make a 
              hardcopy copy, the same plot file to send to the device LASER.
\xe\sxe