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(). |