Shutter

Description

Returns or sets the row value of the shutter


Syntax

[VB]
objActiveDcam.Shutter [= Value]

[C/C++]
HRESULT get_Shutter( long *pShutter );
HRESULT put_Shutter( long Shutter );


Data Type [VB]

Long

Parameters [C/C++]

pShutter [out,retval]

Pointer to the current shutter value

Shutter [in]

The shutter value 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 demonstrates the use of a scroll control for real-time adjustment of the camera's shutter.

Private Sub Form_Load()
ActiveDcam1.Acquire=True
HScroll1.Value = ActiveDcam1.Shutter
HScroll1.Min = ActiveDcam1.GetShutterMin
HScroll1.Max = ActiveDcam1.GetShutterMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.Shutter = HScroll1.Value
End Sub

Remarks

This property changes the integration time of the camera's sensor to a sub-value of the frame period. Depending on the camera model, the raw shutter value can be directly or inversly related to the integration time physical value. The valid property range is reported by the GetShutterMin and GetShutterMax methods. Note that the property is available only if the currently selected camera supports software shutter control.