bit_notbit_notBitNotBitNotbit_not (Operator)

Name

bit_notbit_notBitNotBitNotbit_not — Complement all bits of the pixels.

Signature

bit_not(Image : ImageNot : : )

Herror bit_not(const Hobject Image, Hobject* ImageNot)

Herror T_bit_not(const Hobject Image, Hobject* ImageNot)

void BitNot(const HObject& Image, HObject* ImageNot)

HImage HImage::BitNot() const

static void HOperatorSet.BitNot(HObject image, out HObject imageNot)

HImage HImage.BitNot()

def bit_not(image: HObject) -> HObject

Description

The operator bit_notbit_notBitNotBitNotBitNotbit_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

Parameters

ImageImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4)

Input image(s).

ImageNotImageNotImageNotImageNotimageNotimage_not (output_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject * (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)

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_notBitNotBitNotBitNotbit_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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) If necessary an exception is raised.

Alternatives

bit_orbit_orBitOrBitOrBitOrbit_or, bit_andbit_andBitAndBitAndBitAndbit_and, add_imageadd_imageAddImageAddImageAddImageadd_image

See also

bit_slicebit_sliceBitSliceBitSliceBitSlicebit_slice, bit_maskbit_maskBitMaskBitMaskBitMaskbit_mask

Module

Foundation