% @(#)resampimag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:54
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      resampimag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, RESAMPLE/IMAGE
%.PURPOSE    On-line help file for the command: RESAMPLE/IMAGE
%.VERSION    1.0  05-FEB-1998 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
RESAMPLE/IMAGE	                                        31-JUL-2001  KB
\oc\su
RESAMPLE/IMAGE in out stepping
	resample an image
\us\pu
Purpose:  
          Resample an image with half or double stepsize.
\up\sy
Syntax: 
          RESAMPLE/IMAGE in out stepping
\ys\pa
          in = input frame
\ap\pa
          out = output frame 
\ap\pa
          stepping = HALF_STEP or DOUBLE_STEP to subsample the input frame 
               or omit each other sample of input frame;
               defaulted to HALF_STEP
\ap\sa
See also:
          REBIN/LINEAR
\as\no
Note:  
             For `stepping' set to HALF_STEP (i.e. subsampling) between each
          input pixel an additional pixel value will be added using linear 
          interpolation. Thus, the no. of pixels for the result frame will be
          (2*xpix - 1) per row. Also, between two resampled rows a complete
          new row will be added by linearly interpolating all pixels between 
          the two resampled rows, so also the no. of rows of the result frame
          will be (2*ypix - 1).
          New stepsizes will be half the stepsizes of input frame.
             For `stepping' set to DOUBLE_STEP every second pixel and row of
          the input frame is omitted. Thus, result frame will have 
          (xpix+1)/2 pixels and (ypix+1)/2 rows.
          New stepsizes will be twice the stepsizes of input frame.
\\ 
             No flux conservation is done, e.g. after subsampling the total
          intensity of the result frame will be approx. 4 times the intensity
          of the input frame.
\on\exs
Examples:
\ex
          RESAMPLE/IMAGE conejo tortuga double_step
            Omit every second pixel of a row and every second complete row 
            of image `conejo.bdf' and copy all others to `tortuga.bdf'.
\xe\ex
          RESAMPLE/IMAGE conejo tortuga 
            Add additional pixels for each row of `conejo.bdf' and complete 
            new rows between two resampled rows.
\xe \sxe