BitShift

Description

Returns or sets the bit shift value for 16-bit and 48-bit video modes.


Syntax

[VB]
objActiveDcam.BitShift [= Value]

[C/C++]
HRESULT get_BitShift( long *pShutter );
HRESULT put_BitShift( long Shutter );


Data Type [VB]

Long

Parameters [C/C++]

pBitShift [out,retval]

Pointer to the current bit shift

BitShift [in]

The bit shift to be set

Return Values

S_OK

Success

E_FAIL

The shutter control is not available for the selected camera

E_INVALIDARG

The value is out of range

Example

The following VB example sets the bit shift to 6.

ActiveDcam1.BitShift=6

Remarks

This property defines the right bit shift to be applied to 16-bit pixel values in the image buffer. When displaying and saving 16- and 48-bit images, ActiveDcam assumes that pixel values are mapped to the whole 16-bit dynamic range (0-65535). Certain cameras however may output data in narrower dynamic range resulting in dark images, in which case the BitShift property must be used. For example, if the original pixel values have the dynamic range of 10 bits (0-1023), setting BitShift to 6 will cause the real-time mapping of images to the entire 16-bit scale.

Note that this property is availalbe only in 16- and 48-bit video Modes.