AcquisitionMode

Description

Returns or sets the acquisition mode of the camera which defines how many frames will be captured when Acquire is set to true. Can be one of the following values:

"SingleFrame"

One frame is captured

"MultiFrame"

The number of frames to capture is specified by AcquisitionFrameCount

"Continuous"

Frames are captured continuously until Acquire is set to FALSE

Syntax

[VB]
objActiveGige.AcquisitionMode [= Value]

[C/C++]
HRESULT get_AcquisitionMode( bstr *pValue );
HRESULT put_AcquisitionMode( bstr Value );


Data Type [VB]

String

Parameters [C/C++]

pValue [out, retval]

Pointer to the string specifying the current acquisition mode

Value [in]

The acquisition mode to be set

Return Values

S_OK

Success

E_NOINTERFACE

The feature is not available for the selected camera

E_INVALIDARG

The value is not part of the enumerated set

E_FAIL

Failure to set the feature value

Example

The following VB example activates the acquisition of 100 frames:

ActiveGige1.AcquisitionFrameCount=100
ActiveGige1.AcquisitionMode = "MultiFrame"
ActiveGige1.Acquire=TRUE

Remarks

Depending on a camera model, other device-specific values may be available for this feature. The list of valid values can be retrieved using GetEnumList.

The desired acquisition mode must be selected before setting Acquire to TRUE.