The Camera class provides methods for controlling uEye cameras and capturing images. The following classes and methods exist:
Methods
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. The method uses internally the Init() method. Only when no parameters are passed, Init() must be called. |
|
Disables the camera handle and releases the data structures and memory areas taken up by the uEye camera. |
|
Starts the driver and establishes the connection to the camera. |
Property
Property |
Description |
|---|---|
IsOpened |
Refers to the current camera object: •TRUE: camera is open •FALSE: camera is not open |
The Camera class also provides special camera events.
|
Event handling for images If you use the event handling to signal new images from the camera, it may occur under high system load that the event-based application does not receive a signal for every image. This is because the event concept does not provide that several events of the same type are stored. If due to system load more than one image is signaled before the application is ready (e.g. WaitForSingleObject), you have no option to capture these missed events. |
Event |
Description |
|---|---|
uEye.Camera.EventAutoBrightnessFinished |
The automatic brightness control in the run-once mode is completed. |
uEye.Camera.EventAutoFocusFinished |
Automatic focus control is finished (see Focus) |
uEye.Camera.EventCameraMemory |
In the camera memory mode an image acquisition iteration is finished (see ImageBuffer). |
uEye.Camera.EventCaptureStatus |
There is an information about image capturing available. This information can be requested by Information.GetCaptureStatus(). |
uEye.Camera.EventConnectionSpeedChanged |
The connection speed of a USB 3.x camera has been reduced to USB 2.0 speed or has been increased. |
uEye.Camera.EventDevicePluggedIn |
Requirement: the camera is operated in trusted pairing mode (see TrustedPairing). An already paired GigE uEye camera was reconnected to the network. |
uEye.Camera.EventDeviceReconnect |
A camera initialized with Init() and disconnected afterwards was reconnected. |
uEye.Camera.EventDeviceRemove |
A camera initialized with Init() was removed. |
uEye.Camera.EventDeviceUnPlugged |
Requirement: the camera is operated in trusted pairing mode (see TrustedPairing). A paired GigE uEye camera was disconnected from the network. |
uEye.Camera.EventEndOfExposure |
The exposure is finished. This event is triggered after the sensor exposure time has expired. The time between the exposure end and the software event signal is typically < 1 ms. The event is triggered before the uEye.Camera.EventFirstPacket event, as image transfer to the PC is not yet complete when the uEye.Camera.EventEndOfExposure event is transmitted. The event has the restrictions that it is only supported in trigger mode and only by global shutter models of the following camera families (see EndOfExposure): •GigE uEye CP Rev. 2 •GigE uEye FA •GigE uEye SE Rev. 4 •USB 3 uEye CP Rev. 2 (not for models with Sony sensors / UI-3590CP Rev. 2) •USB 3 uEye CP •USB 3 uEye LE •uEye LE USB 3.1 Gen 1 (not for UI-359xLE Rev. 2) •uEye SE USB 3.1 Gen 1 (not for models with Sony sensors) |
uEye.Camera.EventExtTrigger |
An image which was captured following the arrival of a trigger has been transferred completely. This is the earliest possible moment for a new capturing process. The image must then be post-processed by the driver and will be available after the uEye.Camera.EventFrame processing event. |
uEye.Camera.EventFirstPacket |
The first data packet of the image was transferred to the PC. |
uEye.Camera.EventFrame |
A new image is available. |
uEye.Camera.EventFrameSkipped |
The event is signaled when an image was discarded (see CaptureConfiguration). |
uEye.Camera.EventMulticastImageParamsChanged |
Multicast mode: The master has changed camera parameters which affect the data format like image size or color format. The client must reconfigure the virtual camera. |
uEye.Camera.EventSequence |
The sequence is completed (see Sequence). |
uEye.Camera.EventSteal |
An image extracted from the overlay is available (see StealNextFrame) |
uEye.Camera.EventTemperatureStatus |
USB 3 uEye CP Rev. 2/GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4 only: The temperature state of the camera has changed, see Status. |
uEye.Camera.EventWhitebalanceFinished |
The automatic white balance control is completed. |
Example
Example for registering the frame event
private void InitCamera()
{
uEye.Camera Cam = new uEye.Camera();
....
....
// Connect to FrameEvent
Cam.EventFrame += onFrameEvent;
}
private void onFrameEvent(object sender, EventArgs e)
{
// sender is our camera object
uEye.Camera Cam = sender as uEye.Camera;
...
}
