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]
objActiveDcam.Acquire [= Value]

[C/C++]
HRESULT get_Acquire ( bool *pAcquire );
HRESULT put_Acquire( bool Acquire );


Data Type [VB]

Boolean

Parameters [C/C++]

pAcquire [out,retval]

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

Acquire [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
    ActiveDcam1.Acquire=True
    Exit Sub
err_cmdStart:
    MsgBox Err.Description
End Sub

Remarks

If this property is set to TRUE, ActiveDcam 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 rin-time modes. If your development environment doesn't close the design view prior to going to the run-time mode, a conflict will occur between two ActiveDcam 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).