bit_rshift ( Image : ImageRShift : Shift : )

Right shift of all pixels of the image.

The operator bit_lshift calculates a "rechts-Shift" of all pixels of the input image bit by bit. The semantics of the "rechts-Shift" 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

ImageRShift (output_object)
image(-array) -> object : byte / int1 / int2 / int4
Result of shift operation

Shift (input_control)
integer -> integer
shift value
Default value: 3
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 20, 24, 30, 31
Range of values: 0 <= Shift <= 31
Minimum increment: 1
Recommended increment: 1
Restriction: (Shift >= 1) && (Shift <= 31)


Example
bit_rshift(Int2Image,&ReducedInt2Image,8);
convert_image_type__(ReducedInt2Image,&ByteImage,"byte");

Result

If the images are correct (type) and Shift has a valid value the operator bit_rshift 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.


Alternatives

scale__


See also

bit_lshift



Copyright © 1996-1997 MVTec Software GmbH