InitializeCamera

InitializeCamera 1:

Initialize the camera to the intended state (includes sending the 'InitCameraCommands' defined in the GevImageAcquisition TcCOM module to the camera).

Syntax

Definition:

METHOD InitializeCamera : HRESULT

InitializeCamera 2: Return value

HRESULT

Further information

The method InitializeCamera initializes a connected GigE Vision camera just as the parameters in the stored initialization commands have been configured. This method should be used to explicitly control when the camera is initialized. To do this, the InitializationAutoMode in the TcCOM parameters of the Image Acquisition object must be set to NO_AUTOINIT. As a result of this, no automatic camera initialization is performed; instead, it must be done manually by means of InitializeCamera.

If a different selection was made with InitializationAutoMode, an automatic initialization takes place and the InitializeCamera method is not required

The initialization of a GigE Vision camera consists of the following steps:

  1. Opening the Control Channel to the camera
  2. Executing the Force-IP commands (optional)
  3. Setting a UserSet or writing Initialization Commands.

The function block assumes the INITIALIZING state during initialization. The function block enters the INITIALIZED state once the initialization is complete. It also assumes this state if the camera connection in the OPENED state is closed by calling the method CloseCamera.

State transitions

With InitializeCamera, the camera is to be brought from the INITIAL state to the INITIALIZED state. As a rule, this transition takes place via the intermediate state INITIALIZING.

InitializeCamera 3:
State transitions with FB_VN_GevCameraControl.InitializeCamera

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

Return Codes (HRESULT)

Result state

INITIAL

INITIALIZING

INITIALIZED

ERROR

Initial state

INITIAL

BUSY

PENDING

SUCCESS

FAILED

INITIALIZING

-

BUSY