Acquire

Description

Enables/disables the continuous acquisition mode. If the acquisition mode is enabled and the Display property is turned on, the live video will be displayed in the control window.

Syntax

[VB]
objActiveGige.Acquire [= Value]

[C/C++]
HRESULT get_Acquire ( bool *pValue );
HRESULT put_Acquire( bool Value );


Data Type [VB]

Boolean

Parameters [C/C++]

pValue [out,retval]

Pointer to the Boolean that is TRUE if the continuous acquisition is enable, or FALSE otherwise

Value [in]

Set to TRUE to enable the continuous acquisition, or set to FALSE otherwise

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example activates the continuous acquisition mode upon clicking the Start button:

Private Sub cmdStart_Click()
On Error GoTo err_cmdStart
    ActiveGige1.Acquire=True
    Exit Sub
err_cmdStart:
    MsgBox Err.Description
End Sub

Remarks

If this property is set to TRUE, ActiveGige will continuously acquire the video into the internal image memory. The FrameAcquired event will be generated upon completing each frame. To access the content of the image memory, use GetPixel, GetLine, GetImageWindow and GetImageData methods.

Note that this property works in both the design and run-time modes. If your development environment does not close the design view prior to going to the run-time mode, a conflict will occur between two ActiveGige objects trying to acquire the video from the same camera. In order to prevent this, it is recommended to keep the Acquire property set to FALSE in the design mode and turn it on by an explicit command in the program code (see the example above).

Use AcquisitionMode to set up the desired acquisition mode prior to setting Acquire to TRUE.