imaqEqualize

Usage

int imaqEqualize(Image* dest, const Image* source, float min, float max, const Image* mask);

Purpose

Calculates the histogram of an image and redistributes pixel values across the desired range to maintain the same pixel value distribution. Pixels whose values are the same before the redistribution also have common pixel values after the redistribution.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name	Type	Description
dest	Image*	The destination image.
source	const Image*	The source image.
min	float	The minimum value of the range to which the function equalizes the image.
max	float	The maximum value of the range to which the function equalizes the image.
mask	const Image*	An optional mask image. This image must be an IMAQ_IMAGE_U8 image. The function equalizes only those pixels in the source image whose corresponding pixels in the mask are non-zero. Set this parameter to NULL to equalize the whole image.

Return Value

Type	Description
int	On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().