Genie Color Series-GigE Vision Camera
Operational Reference
69
Events
Genie supports a number of events that a control application can monitor. Events provide real time notification on
various stages of the acquisition sequence and of error conditions. A Sapera application registers callbacks for those
events that need monitoring.
Sapera Callbacks
Three types a callbacks can be registered for events when using the Genie:
Transfer events
concerning host system buffers.
Use the Sapera Transfer Module
In the Sapera C library: see CorXferRegisterCallback
In the + library: see SapXferCallbackInfo class
Acquisition events
concerning the acquisition device, specifically the Genie camera.
Use the Sapera Acquisition Module
In the Sapera C library: see CorAcqDeviceRegisterCallbackByName or
CorAcqDeviceRegisterCallbackByName
In the + library: see SapAcqDeviceCallbackInfo class
Sapera events generated for GigE Vision devices
(see SapManager::RegisterServerCallback). Note that if
Genie cameras are connected through an Ethernet switch, these GigE Vision events can only be generated after
the Auto Discovery polling function of the GigE Vision driver.
SapManager::EventServerNew — A new device such as a Genie, has been connected while the Sapera
application is running. Resources are allocated for the device.
SapManager::EventServerNotAccessible — The device is not accessible (device is disconnected). Sapera
resources for the device do not have to be destroyed if it is expected that the device will be reconnected.
SapManager::EventServerAccessible — The device is accessible again (device reconnected). Sapera
resources for the device if not previously destroyed, will be used again.
Feature Event Name
(case sensitive strings)
Description
Start of Trigger
Trigger is valid based on the programmed trigger parameters
Start of Exposure
Exposure has started
End of Exposure
Exposure is complete
End of Acquisition
Transfer of image is terminated from camera.
This does not mean that the host PC has received all data packets.
End of Readout
End of image readout from sensor to onboard buffer
Feature Value Changed
Parameter value is changed
Feature Info Changed
One or more parameter components has changed, such as a maximum or minimum
range limit, access mode, enumeration element, or parameter value.
Invalid Trigger
Trigger event (software or external) was invalid
Input Event 0
External Input # 1 has received a valid signal
Input Event 1
External Input # 2 has received a valid signal
Output Event 0
External Output # 1 has changed state
Output Event 1
External Output # 2 has changed state
