NAME

     libmap - CVIPtools toolkit library containing utilities  for
     mapping data and manipulating data sets

SYNOPSIS

     #include <CVIPmap.h>

FUNCTIONS

     libmap includes the following functions:
                          condRemap_Image
                          linearTrans_Image
                          logMap_Image
                          remap_Image
                          trun_Image

NAME

     ===================================================================
     Image *condRemap_Image(const Image *imageP, CVIP_TYPE dtype,
     unsigned            min,            unsigned            max)
     ===================================================================

DESCRIPTION

     <imageP> - pointer to Image structure <dtype> - type of  the
     data  to  be  mapped to (e.g. CVIP_BYTE).  must be either as
     precise or less precise than that of the input image.  <min>
     -  minimum value in range (e.g. 0 ) <max> - maximum value in
     range (e.g. 255 )

     Returns: pointer to a new instance  of  the  Image  <imageP>
     that   has  been  mapped  into  the  range  [<min>...<max>].
     Description: Called if a non-byte image  is  passed  to  the
     image viewer. Performs conditional remapping procedure: data
     in range 0-255 is not remapped; data more than 0.499 outside
     specified range is completely remapped.  Author(s): Kun Luo,
     Arve Kjoelen.

NAME

     ===================================================================
     void    linearTrans_Image(float    **cvecP,   unsigned   int
     no_of_vecs,  unsigned  int   vdim,   double   **transmatrix)
     ===================================================================

     <cvecP> - pointer to an array of band vectors <no_of_vecs> -
     number  of vectors <vdim> - dimension of each vector (number
     of pixels) <transmatrix> - transformation matrix

     Description: linearly  transforms  a  set  of  band  vectors
     <cvecP>  through  a transformation matrix <transmatrix>. The
     transformation  matrix  must  be   have   a   dimension   of
     <no_of_vecs> by <no_of_vecs>.  Author(s): Gregory Hance.

NAME

     ===================================================================
     Image *logMap_Image(image *image, int band)
     ===================================================================

     <image> - Pointer to Image structure.
     <band> - the band to do logarithmic mapping;
              -1=all bands, 0=1st band, 1=2nd band, etc.

DESCRIPTION

     This function remaps a transformed image  using  logarithmic
     mapping.    The   resulting   spectra  Image   structure  is
     returned. The "band" specifies on which  band  to  do  loga-
     rithmic mapping. If band == -1, or band > [(number of bands)
     - 1] all bands will be remapped;  otherwise  only  one  band
     will  be remapped and the return Image is a grayscale image.
     For example, with a color, three-band, RGB image: 0 = Red, 1
     = Green, 2 = Blue.  Author(s): Simon Lowh, Yansheng Wei

NAME

     ===================================================================
     Image  *remap_Image(const  Image  *imageP,  CVIP_TYPE dtype,
     unsigned           dmin,           unsigned            dmax)
     ===================================================================

DESCRIPTION

     <imageP> - pointer to Image structure <dtype> - type of  the
     data  to  be  mapped to (e.g. CVIP_BYTE).  must be either as
     precise or less  precise  than  that  of  the  input  image.
     <dmin>  -  minimum value in range (e.g. 0 ) <dmax> - maximum
     value in range (e.g. 255 )

     Returns: pointer to a new instance  of  the  Image  <imageP>
     that  has  been  mapped  into  the  range [<dmin>...<dmax>].
     Description: performs remapping procedure in which the rela-
     tive  size of each data band is maintained.  Author(s): Gre-
     gory Hance.

NAME

     ===================================================================
     void trun_Image(const Image *imageP, type dtype, long dmin, long dmax)
     ===================================================================

     <imageP> - Pointer to Image structure.
     <dtype> - type of the data to be mapped to (e.g. CVIP_BYTE). Must be either
     as precise or less precise.
     <dmin> - minimum value in range (e.g. 0 )
     <dmax> - maximum value in range (e.g. 255 )

DESCRIPTION

     This function remaps an image, maintaining the relative size
     of each data band.

PATH

     $CVIPHOME/Mapping/relremap.c

     Author(s): Kun Luo

BUGS

     none known

SEE ALSO

     CVIPtools library quick reference guide

AUTHOR

     Copyright (C) 1992, 1993 SIUE - by Gregory Hance  and  Scott
     Umbaugh.