% @(#)copy_grap.hlq	19.1 (ESO-IPG) 02/25/03 14:03:07
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.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]   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 if 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
              COPY/GRAP ptcol5.c
                Copy current plot file to the colour printer with name
		ptcol5 (in landscape mode).
\xe\ex
              COPY/GRAP ptcol5.c.p
                Copy current plot file to the colour printer with name
		ptcol5 in portrait mode.
\xe\ex
              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.tbl' and 
		overplot column 1 versus column 3.
                Finally, the plot is sent to ps4ipg1 and will come out
	        in portrait mode.
\xe\ex
              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.tbl'. 
		A file `postscript.ps' will be created and will contain the
		graphics. Finally, to make a hardcopy, the same plot
		file is sent to the device LASER.
\xe\sxe
