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, unsigned short, 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.
|
Image (input_object) |
(multichannel-)image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 |
| Input image(s). | |
|
ImageMask (output_object) |
(multichannel-)image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 |
| Result image(s) by 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 | |
If the images are correct (type) the operator bit_mask 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.
bit_mask is reentrant and automatically parallelized (on tuple level, channel level, domain level).
Image filters
