bit_mask ( Image : ImageMask : BitMask : )

Logical "and" of each pixel using a bit mask.

The operator bit_mask carries out an "and" operation of each pixel with a fixed mask. The semantics of the "and" operation corresponds to that of C for the respective types (signed char, unsigned char, 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)
image(-array) -> object : byte / int1 / int2 / int4
Input image

ImageMask (output_object)
image(-array) -> object : byte / int1 / int2 / int4
Result of combination with mask

BitMask (input_control)
integer -> integer
Bit field
Default value: 128
List of values: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096
Suggested values: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096


Result

If the images are correct (type) the operator bit_mask returns the value 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 is raised.


Possible Successors

threshold__, bit_or


Alternatives

bit_slice


See also

bit_and, bit_lshift



Copyright © 1996-1997 MVTec Software GmbH