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.