imaqBCGTransform
Usage
int imaqBCGTransform(Image* dest, const Image* source, const BCGOptions* options, const Image* mask);
Purpose
Applies brightness, contrast, and gamma correction to an image by computing and applying a lookup table. The function computes the lookup table based on the values in BCGOptions.
Image Types Supported
IMAQ_IMAGE_U8
Parameters
Name
|
Type
|
Description
|
---|---|---|
dest | Image* | The destination image. |
source | const Image* | The image to transform. |
options | const BCGOptions* | The parameters to use in the transform. This parameter is required and cannot be NULL. |
mask | const Image* | An optional mask image. This image must be an IMAQ_IMAGE_U8 image. The function applies the transform only to those source pixels whose corresponding mask pixels are non-zero. All other pixel remain unchanged. Set this parameter to NULL to apply the transform to the whole source 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(). |
Parameter Discussion
options—If NULL is passed, the function uses the following default parameters:
brightness | 128 |
contrast | 45 |
gamma | 1.0 |