lshiftIm

lshiftIm ( integer Input, integer Output [, integer Shift =1 )

Use this function to perform a bitwise left shift on all pixels of an image or selection. Bits vacated by the shift operation are filled with zero

Parameters

Input

An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.

Output

An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.

Shift

An optional integer between 1 and 32 specifying the amount of bits at which pixels will be shifted.

Default value: 1

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements performs the bitwise left shift of a sample image:

setCurDir("samples")

loadIm (1,"sample7.iwd")

lshiftIm (1,2, 5)

Remark

Floating and complex images cannot be processed by this function.