StartAcquisition

StartAcquisition 1:

Activates the File Source. If not in trigger mode, it will start sending images.

Syntax

Definition:

METHOD StartAcquisition : HRESULT

StartAcquisition 2: Return value

HRESULT

Further information

The method StartAcquisition starts the loading of the images. Depending on the trigger mode setting, this may mean providing images directly or waiting for a trigger signal. The image loading can be started from the INITIAL and OPENED states.

State transitions

With StartAcquisition the file source is to be placed in the ACQUIRING state. This can take place from the INITIAL and OPENED states. If the File Source is in INITIAL, the state transition to OPENED is performed first. As a rule, this takes place via the intermediate state OPENING. The transition from OPENED to ACQUIRING usually takes place via the intermediate state STARTACQUISITION.

All possible state transitions and their return codes are shown in the following transition matrix:

Return Codes (HRESULT)

Result state

INITIAL

OPENING

OPENED

STARTACQUISITION

ACQUIRING

ERROR

Initial state

INITIAL

BUSY

PENDING

SUCCESS

-

-

FAILED

OPENING

-

BUSY

OPENED

-

BUSY

PENDING

SUCCESS

STARTACQUISITION

-

BUSY