---

csuCommonImage.h

Go to the documentation of this file.

#ifndef CSU_IMAGE_INCLUDED
#define CSU_IMAGE_INCLUDED

namespace csu{
#define PIX_TYPE double
#define RASTER_ID "CSU_RASTER"

//#define INTERPOLATE_FAST 1

typedef struct{
    int width;
    int height;
    int channels;
    PIX_TYPE*** data;
} image;

typedef image* Image;

Image makeImage(int width,int height,int channels);
Image makeZeroImage(int width,int height,int channels);
void freeImage(Image i);

Image duplicateImage(Image im);



/********************* Image Access Functions *******************/

/* Access a single image element using dope vector expantion. symantics: img[x,y,c] */
#define IE( img , x , y , c )   ( (img)->data[(x)][(y)][(c)] )

/* Safe read-only/range-checked implementation of IE - returns 0.0 if off image. */
#if(!INTERPOLATE_FAST)
PIX_TYPE ie(Image img, int x, int y, int c);
#else
#define ie( img , x , y , c ) ((x < img->width && y < img->height && c < img->channels && x >= 0 && y >=  0 && c >= 0) ? IE(img, x, y, c) : 0.0 )
#endif
/* interpolate a pixel value at a point */


#if(!INTERPOLATE_FAST)
PIX_TYPE interpLinear(Image img, PIX_TYPE x, PIX_TYPE y, int c);
#else
/* Error in Code #define interpLinear(img, x, y, c) ; */
#endif

/********************* Image Manipulation Functions *******************/

Image convolveImage(const Image im, const Image mask);

double convolvePoint(PIX_TYPE x, PIX_TYPE y, int c, const Image im, const Image mask);

void contrastImage(Image im, double scalar);
    /* Multiplies everyvalue in im by scalar */

void brightnessImage(Image im, double scalar);
    /* Adds scalar to every value in im */

void ZeroMeanUnitLength(Image im);
/* scales the pixel so that they have zero mean and the image is unit length*/
void ZeroMeanUnitLengthMasked(Image im, const char **mask);
/* scales the pixel so that they have zero mean and the image is unit length*/

void ZeroMeanOneStdDev(Image im);
/* scales the pixel so that they have zero mean and the image is unit length*/
void ZeroMeanOneStdDevMasked(Image im, const char **mask);
/* scales the pixel so that they have zero mean and the image is unit length*/

double corrilateImages(const Image i1, const Image i2);
/* findes the corrilation between two images */
double dotImages(const Image i1, const Image i2);
/* find the corrilation for images that have zero mean and unit length */

Image computeMeanImage(Image* images, int count);
/* takes an array of images and returns the mean of those images.*/

Image accumulateChannels(const Image im);
/* generates a new image that is the sum of all channels. */

void accumulateImages(Image i1, const Image i2);
/* inplace adds image i2 to image i1 */

void gaussianBlur(Image im, double sigma);

/* Add gausian noise to the image. s is the standard
 * deviation relative to the total image range returns the actual standard deviation
 * of the applied noise
 */
double gaussianNoise(Image im, double s);

/* Performs a histogram equalization function.  Output values are in the range 0 to 1 */
void histEqual(Image i, int num_bins);
void histEqualMask(Image i, int num_bins, const char **mask);

/* Smooth image borders */
void smoothImageEdge(Image i, int width);

/* Zero all pixels not in a mask */
void applyMask(Image im, const char **mask);

PIX_TYPE imageMax(Image im);

void markPoint(Image im, PIX_TYPE x, PIX_TYPE y);

Image makeThurmalColorImage(Image im);

Image makeThurmalComboImage(Image thrm, Image bw);


/********************* Image File I/O Functions *******************/

Image readPGMImage(const char*);
Image readRawImage(const char*);
Image readFeretImage(const char *fname, int width, int height,int channels);

void  writePGMImage(const Image, const char*,int channel);
void  writePPMImage(const Image, const char*);
void  writeRawImage(const Image, const char*);
void  writeFeretImage(const Image im, const char *fname);

/********************* Image Statistics ************************************/

typedef struct{
    PIX_TYPE max, min, mean, variance, stddev;
    int max_x, max_y, max_c, min_x, min_y, min_c;
} image_statistics;

typedef image_statistics* ImageStatistics;

ImageStatistics computeImageStatistics(Image im);
ImageStatistics computeImageStatisticsLocal(Image im, int x, int y, int dist);
}
#endif

---