imaqMathTransform
Usage
int imaqMathTransform(Image* dest, const Image* source, MathTransformMethod method, float rangeMin, float rangeMax, float power, const Image* mask);
Purpose
Transforms an image by applying a transfer function to the value of each pixel. The function applies the transform T(x) over a specified input range [rangeMin, rangeMax] in the following manner:
T(x) = dynamicMin if x <= rangeMin
f(x) if rangeMin < x <= rangeMax
dynamicMax if x > rangeMax
where
dynamicMin = 0 (8-bit images) or the smallest initial pixel value (16-bit and floating point images)
dynamicMax = 255 (8-bit images) or the largest initial pixel value (16-bit and floating point images)
dynamicRange = dynamicMax - dynamicMin
The function scales f(x) so that f(rangeMin) = dynamicMin and f(rangeMax) = dynamicMax. f(x) behaves on (rangeMin, rangeMax) according to the method you select.
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. |
| method | MathTransformMethod | The transform function to use. |
| rangeMin | float | The smallest pixel value on which the function applies the transform. |
| rangeMax | float | The largest pixel value on which the function applies the transform. |
| power | float | If you set method to IMAQ_TRANSFORM_POWX or IMAQ_TRANSFORM_POW1X, power specifies the power to which the function raises the value. |
| mask | const Image* | An optional mask. This image must be an IMAQ_IMAGE_U8 image. The function transforms only those source pixels whose corresponding mask pixels are non-zero. All other pixels remain unchanged. Set this parameter to NULL to apply the transform to 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(). |