bit_notbit_notBitNotBitNotbit_not (Operator)
Name
bit_notbit_notBitNotBitNotbit_not — Complement all bits of the pixels.
Signature
def bit_not(image: HObject) -> HObject
Description
The operator bit_notbit_notBitNotBitNotbit_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.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
- Automatically parallelized on domain level.
Parameters
ImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4)
Input image(s).
ImageNotImageNotImageNotimageNotimage_not (output_object) (multichannel-)image(-array) → objectHImageHObjectHObjectHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4)
Result image(s) by complement operation.
Example (HDevelop)
read_image(Image,'monkey')
dev_display(Image)
bit_not(Image,ImageBitNot)
dev_display(ImageBitNot)
Example (C)
read_image(&Image,"monkey");
disp_image(Image,WindowHandle);
bit_not(Image,&ImageBitNot);
disp_image(ImageBitNot,WindowHandle);
Example (HDevelop)
read_image(Image,'monkey')
dev_display(Image)
bit_not(Image,ImageBitNot)
dev_display(ImageBitNot)
Example (HDevelop)
read_image(Image,'monkey')
dev_display(Image)
bit_not(Image,ImageBitNot)
dev_display(ImageBitNot)
Result
If the images are correct (type) the operator bit_notbit_notBitNotBitNotbit_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>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)
If necessary an exception is raised.
Alternatives
bit_orbit_orBitOrBitOrbit_or,
bit_andbit_andBitAndBitAndbit_and,
add_imageadd_imageAddImageAddImageadd_image
See also
bit_slicebit_sliceBitSliceBitSlicebit_slice,
bit_maskbit_maskBitMaskBitMaskbit_mask
Module
Foundation