% @(#)insertimag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:41 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      insertimag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, INSERT/IMAGE
%.PURPOSE    On-line help file for the command: INSERT/IMAGE
%.VERSION    1.0  07-MAR-1985 : Creation, KB
%.VERSION    1.2  14-MAY-1991 : Update, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
INSERT/IMAGE					14-MAY-1991  KB
\oc\su
INSERT/IMAGE subframe modframe [startx,y,z]
	insert a subframe into another frame
\us\pu
Purpose: 
          Insert a subframe into another frame.
\up\sy
Syntax:
          INSERT/IMAGE subframe modframe [startx,y,z]
\ys\pa
          subframe = name of image frame which will be inserted in the other
\ap\pa
          modframe = name of image frame into which 'subframe' will be inserted;
\\
                parts or all of modframe will be overwritten with the pixels
                of subframe, depending upon the start values
\ap\pa
          startx,y,z = optional start coordinates for subframe within modframe;
\\
                if omitted the start coords. will be taken from the descriptor
                START of the subframe
\ap\sa
See also:
          EXTRACT/IMAGE
\as\no
Note:  
          startx,starty,startz can be in any of the following formats:
\\
            -  any number, to indicate real world coordinates;
\\
            -  an integer number preceded by @, to indicate a pixel number;
\\
            -  the symbols "<" and ">", to indicate start or end pixel
\\
          the startvalues may also be negative, i.e. "before" the start of
          the modframe, so that only the overlapping part of the subframe is
          put into the modframe
\\
          since @1 indicates first pixel, @0 means 1 pixel outside and @-1
          actually puts the begin of the insertion 2 pixels outside modframe!
\on\exs
Examples:
\ex
          INSERT/IMA sun galaxy
          insert frame sun.bdf into galaxy.bdf, the position of sun within 
          galaxy will be determined by descriptor START of sun.bdf
\xe\ex
          INSERT/IMA sun galaxy @22,@100
          insertion of the data of sun.bdf will begin at the 22th x-pixel
          and the 100th y-pixel of frame galaxy.bdf (assuming, that both frames
          are 2-dimensional frames)
\xe\ex
          INSERT/IMA sun galaxy @-1,@-1
          insert sun.bdf into galaxy.bdf, sun will begin two pixels and two
          lines outside of modframe, therefore only from pixel 3 and line 3 on
          are data overlapping and thus inserted into galaxy.bdf
\xe \sxe