imaqInverse
Usage
int imaqInverse(Image* dest, const Image* source, const Image* mask);
Purpose
Inverts the pixel intensities of an image using the following equation:
f(p) = dynamicMax - p + dynamicMin
where
p represents the value of a pixel.
dynamicMin represents 0 (8-bit images) or the smallest pixel value in the source image (16-bit and floating point images).
dynamicMax represents 255 (8-bit images) or the largest pixel value in the source image (16-bit and floating point images).
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 image to invert. |
| mask | const Image* | An optional mask image. This image must be an IMAQ_IMAGE_U8 image. The function inverts only those pixels in the source image whose corresponding pixels in the mask are non-zero. Set this parameter to NULL to invert the pixel intensities of the entire 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(). |