Name | Synopsis | Description | Parameters | Return Values | Attributes | See Also
cc [ flag... ] file... -lmlib [ library... ] #include <mlib.h> mlib_status mlib_ImageInvert(mlib_image *dst, const mlib_image *src);
The mlib_ImageInvert() function performs the inversion of an image such that white becomes black, light gray becomes dark gray, and so on.
It uses the following equation:
dst[x][y][i] = (Gwhite + Gblack) - src[x][y][i]
The values of Gwhite and Gblack for different types of images are:
Image Type |
Gwhite |
Gblack |
Gwhite + Gblack |
---|---|---|---|
MLIB_BYTE |
255 |
0 |
255 (0xFF) |
MLIB_SHORT |
32767 |
-32768 |
-1 (0xFFFF) |
MLIB_USHORT |
65535 |
0 |
65535 (0xFFFF) |
MLIB_INT |
2147483647 |
-2147483648 |
-1 (0xFFFFFFFF) |
Given that integer data are in the two's complement representation, mlib_ImageInvert() is the same as mlib_ImageNot(), while mlib_ImageInvert_Inp() is the same as mlib_ImageNot_Inp().
The function takes the following arguments:
Pointer to destination image.
Pointer to source image.
The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Interface Stability |
Committed |
MT-Level |
MT-Safe |
mlib_ImageInvert_Inp(3MLIB), mlib_ImageInvert_Fp(3MLIB), mlib_ImageInvert_Fp_Inp(3MLIB), attributes(5)
Name | Synopsis | Description | Parameters | Return Values | Attributes | See Also