imaqColorBCGTransform

Usage

int imaqColorBCGTransform(Image* dest, const Image* source, const BCGOptions* redOptions, const BCGOptions* greenOptions, const BCGOptions* blueOptions, const Image* mask);

Purpose

Applies brightness, contrast, and gamma correction to each plane of a color image.

Image Types Supported

IMAQ_IMAGE_RGB

Parameters

Name	Type	Description
dest	Image*	The destination image.
source	const Image*	The image to transform.
redOptions	const BCGOptions*	The parameters to use in the transform of the red plane. Set this parameter to NULL to leave the red plane unchanged.
greenOptions	const BCGOptions*	The parameters to use in the transform of the green plane. Set this parameter to NULL to leave the green plane unchanged.
blueOptions	const BCGOptions*	The parameters to use in the transform of the blue plane. Set this parameter to NULL to leave the blue plane unchanged.
mask	const Image*	An optional mask image. This image must be an IMAQ_IMAGE_U8 image. The function transforms only those pixel in the source image whose corresponding pixels in the mask image are non-zero. Set this parameter to NULL to transform 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().