bit_not

bit_not ( Image : ImageNot : : )

Complement all bits of the pixels.

The operator bit_not calculates the ``complement'' of all pixels of the input image bit by bit. The semantics of the ``complement'' operation corresponds to that of C (``~'') for the respective types (signed char, unsigned char, short, unsigned short, int/long). Only the pixels within the definition range of the image are processed.

Several images can be processed in one call. An output image is generated for every input image.

Parameters

`Image` (input_object)	(multichannel-)image(-array) `->` object : byte / direction / cyclic / int1 / int2 / uint2 / int4
Input image(s).

`ImageNot` (output_object)	(multichannel-)image(-array) `->` object : byte / direction / cyclic / int1 / int2 / uint2 / int4
Result image(s) by complement operation.

Example

read_image(Image0,'affe') 
disp_image(Image0,WindowHandle) 
bit_not(Image0,ImageBitN) 
disp_image(ImageBitN,WindowHandle).

Result

If the images are correct (type) the operator bit_not returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:) If necessary an exception handling is raised.

Parallelization Information

bit_not is reentrant and automatically parallelized (on tuple level, channel level, domain level).

Alternatives

bit_or, bit_and, add_image

See also

bit_slice, bit_mask

Module

Foundation