% @(#)copy_over.hlq	19.1 (ESO-IPG) 02/25/03 14:03:08 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_disp.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/OVERLAY
%.PURPOSE    On-line help file for the command: COPY/OVERLAY
%.VERSION    1.0  27-JUL-1996 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./OVER
\es\co
COPY/OVERLAY					27-JUN-1996  KB
\oc\su
COPY/OVERLAY [chanl] [append_flag]
	copy all graphics and text from the overlay plane to image channel
\us\pu
Purpose: 
          Copy (redraw) all graphics and text from the overlay plane to 
          image channel.
\up\sy
Syntax: 
          COPY/OVERLAY [chanl] [append_flag]
\ys\pa
          chanl = image channel; defaulted to 0
\ap\pa
          append_flag = APPEND or NOT_APPEND;
\\
              defaulted to APPEND, i.e. any existing graphs in the image
              channel are kept
\ap\sa
See also:
          SET/OVERLAY, CLEAR/OVERLAY, DRAW commands 
\as\no
Note:
          Copying the overlay plane to an image channel consists of redrawing
          all graphs and text strings from the overlay plane in the given
          image channel. After that you can erase the contents of the overlay 
          plane and draw new graphs in it.
\on\exs
Examples:
\ex
          COPY/OVERLAY
            Redraw all overlay graphs/labels in image channel no. 0.
\xe\ex
          COPY/OVERLAY 1 NO
            Erase any existing graph/label in image channel no. 1 and copy
            all graphs from the overlay plane to it.
\xe \sxe
