Acquire
Top  Previous  Next

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).