Please enable JavaScript to view this site.

uEye .NET Manual 4.97

Class

uEye.Camera

Accessible

Camera.Init

Syntax

uEye.Camera.Init(int s32Cam, int s32hWnd)

uEye.Camera.Init(int s32Cam, System.IntPtr WindowHandle)

uEye.Camera.Init(int s32Cam)

uEye.Camera.Init()

Description

Starts the driver and establishes the connection to the camera. When using Direct3D for image display, you can pass a handle to the output window.

hint_info

Starter firmware for camera models GigE uEye cameras

When you are using these camera models, initialization will be aborted with an error message if the camera's starter firmware is not compatible with the installed driver. To initialize the camera, you have to write the proper starter firmware to the camera first. This is done using Init().

Updating the firmware can take up to 20 seconds. It is important not to disconnect the camera from the PC or power supply during this time. Otherwise, malfunctions could occur in the camera.

Camera models GigE uEye SE/RE only: f you have initialized the camera with a driver version earlier than 3.40, you need to update the camera firmware manually using the IDS Camera Manager. Driver versions 3.40 and higher support automatic firmware updates.

hint_info

Note on multi-camera environments

When using multiple cameras in parallel operation on a single system, you should assign a unique camera ID to each camera. To initialize or select a camera with Init(), s32Cam must previously have been set to the desired camera ID.

To initialize or select the next available camera without specifying a camera ID, s32Cam has to be preset with 0.

Parameter

s32Cam

Camera ID
0: The first available camera will be initialized or selected.
1-254: The camera with the specified camera ID will be initialized or selected.

s32Cam | uEye.Defines.DeviceEnumeration.UseDeviceID: The camera is opened using the device ID instead of the camera ID.

s32Cam | uEye.Defines.DeviceEnumeration.AllowStarterFwUpload: During initialization of the camera, this parameter checks whether a new version of the starter firmware is required. If it is, the new starter firmware is updated automatically.
To ensure backward compatibility of applications, always call Init() without the uEye.Defines.DeviceEnumeration.AllowStarterFwUpload parameter first. Only if an error occurs, call the method with this parameter set.

s32hWnd/WindowHandle

Window where the Direct3D image will be displayed

If s32hWnd = IntPtr.Zero, DIB mode will be used for image display.