BitShift
Top  Previous  Next

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.