% @(#)grow_imag.hlq	4.2 (ESO-IPG) 3/16/93 10:56:21 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      grow_imag.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, GROW/IMAGE
%.PURPOSE    On-line help file for the command: GROW/IMAGE
%.VERSION    1.0  20-MAR-1984 : Creation, JDP
%.VERSION    1.1  22-FEB-1993 : Upgrade, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
GROW/IMAGE					22-FEB-1993  KB
\oc\su
GROW/IMAGE out = in [start,step,no] [lincol_specs] [lincol_flag]
	expand single line into 2-dim image
\us\pu
Purpose:    
          Make a 2 dimensional file from a single scan line, repeating
          that line as a line or column a given number of times.
\up\sy
Syntax:     
          GROW/IMAGE out = in [start,step,no] [lincol_specs] [lincol_flag]
\ys\pa
          out = resulting 2 dimensional frame
\ap\pa
          in = 1- or 2-dim frame from which the input line is to be taken
\ap\pa
          start,step,no = the start and step size in the y- or x-dimension
               (depends upon `lincol_flag') of result frame and the no. of
               repetitions, i.e. new y- or x-dimension;
\\
               defaulted to 0.,1.,NPIX(1) of `in' 
\ap\pa
          lincol_specs = `coord,LINE' or `coord,COLUMN' to indicate for a
               2-dim input frame which line or column of the frame is to be
               used as input scan line; the y- or x-coordinate of the line or
               column is defined in the usual MIDAS syntax in pixel or world
               coordinates;
\\
               defaulted to `<,LINE', which indicates the first line
\ap\pa
          lincol_flag = L or C for line- or columnwise repetition of the
               input line/column;
\\
               defaulted to L (also everything else but C is taken as L)
\ap\sa
See also:
          GROW/CUBE, EXTRACT/IMAGE, SHRINK/IMAGE, INSERT/IMAGE, ROTATE/1DIM
\as\no
Note: 
          In general, MIDAS works more efficiently on line oriented frames,
          i.e. frames where the no. of pixels in a line (row) is greater than
          or equal to the no. of columns.
\on\exs
Examples:
\ex
          GROW/IMA mucho = nada 1.,1.,10
            Create 2-dim frame `mucho.bdf' by replicating 10 times the first 
            line of frame `nada.bdf'. Start in y is 1.0 and y-stepsize is 
            also 1.0.
\xe \ex
          GROW/IMA rio.grande = colorado ? @22 col
            Create 2-dim frame `rio.grande' by replicating the 22. line of 
            frame `colorado.bdf' as columns. Start in x is 0.0 and x-stepsize
            is 1.0; the no. of columns (y-dim) of `rio.grande' is NPIX(1) 
            (i.e. x-dim) of `colorado.bdf'.
\xe \sxe