% @(#)copy_ii.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:24 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_ii.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/II
%.PURPOSE    On-line help file for the command: COPY/II
%.VERSION    1.0  28-JUN-1989 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./II
\es\co
COPY/II						22-JAN-1998   KB
\oc\su
COPY/II source_frame dest_frame dest_format flags
	copy source frame to destination frame
\us\pu
Purpose: 
          Copy source frame to destination frame and convert data to
          new format.
\up\sy
Syntax: 
          COPY/II source_frame dest_frame dest_format flags
\ys\pa
          source_frame = name of source frame
\ap\pa
          dest_frame = name of destination frame
\ap\pa
          dest_format = data format of destination frame,
\\
              I1 for bytes, 
\\
              I2 for 16bit integer, UI2 for unsigned 16bit integer,
\\
              I4 for 32bit integer,
\\
              R4 for 32bit real, R8 or D for 64bit real (double precision);
\\
              defaulted to R4
\ap\pa
          flags = string with 2 flags (delete_flag + history_update_flag)
              separated by comma 
\\
              delete_flag = 'D' or 'N', delete or not_delete input frame 
              after copying
\\
              history_update_flag = 'U' or 'N', update or not_update the 
              descr. HISTORY of the dest_frame;
\\
              defaulted to: N,U
\ap\sa
See also:
          CREATE/IMAGE, COPY/IT
\as\no
Note: 
          The type of the frames is defaulted to ".bdf" .
\on\exs
Examples:
\ex
          COPY/II pollo gallo I1
            Copy image frame `pollo.bdf' to frame `gallo.bdf' and convert the
            pixels to 8 bit integer values (bytes).
\xe\ex
          COPY/II gorrion paloma ui2
            Copy image frame `gorrion.bdf' to frame `paloma.bdf' and convert
            the pixels to 16 bit unsigned integer values.
\xe\ex
          COPY/II pollo gallo ui2 d,n
            As above but delete frame `gorrion.bdf' afterwards and don't add
            the line: "COPY/II gorrion paloma ui2 d,n"
            to the descr. HISTORY of output frame `paloma.bdf'.
\xe \sxe