104
Operational Reference
Genie_TS_Series GigE Vision Camera
Using Cycling Presets—an Example
As presented in this category’s overview, the cycling preset features allows setting up camera
configurations that can change dynamically and repeatedly, with a minimum overhead. The
features that change along with the trigger for the feature change are preprogrammed in the
camera. Additionally a set of preset features can be updated while the camera is acquiring with a
different preset. Such dynamic feature changes allow applications to perform tracking algorithms.
The following example describes a simple cycling sequence of exposure and gain change steps
which will repeat until stopped by the user. This example uses the Sapera tool CamExpert to set
features and test the sequence.
Initial Example Setup
For this example, first configure a free running acquisition of 4 fps with an exposure time that’s
somewhat short (dark). These controls are in the Sensor Control Category group within
CamExpert.
Now select the Cycling Preset Category to setup and test the following example.
Set
cyclingPresetMode
to
Active
. This feature enables the Cycling Preset Module.
Set
cyclingPresetCount
to the number of presets which will be configured and used. For this
example set this to 4.
Set the feature
cyclingPresetIncrementalSource
to the event which will be used to increment
the cycling presets index. For this example, set this feature to
StartOfFrame
which is a logical
choice in a free-running acquisition setup.
Set the feature
cyclingPresetRepeater
to the number of incremental source events to count
before switching to the next preset. In this example we are counting
StartOfFrame
events, thus
a value of 4 (with a test setup of 4 fps) will switch presets every one second.
The feature
cyclingPresetResetSource
is optional for this example. This defines the event which
will reset the preset index back to 1. In this example, by setting the feature to
EndOfAcquisition
we know that when Freeze is clicked in CamExpert to stop the free-running acquisition, the
cycling preset index is returned to the start (1).
Cycling Example: Changing Exposure and Gain
The following steps program four presets to create a cycling sequence, starting with
preset index 1.
Set
cP_PresetConfigurationSelector
to index 1.
Set
cP_FeaturesActivationSelector
to
ExposureTime.
Set
cP_FeaturesActivationMode
to
Active
. This defines the camera exposure as one variable
stored in this preset index 1.
The feature
cP_ExposureTime
now is in dark text (active) and shows the last exposure time
used by the camera if cycling was not enabled, or the exposure time of set 1 if cycling was
enabled. This field now controls the camera exposure time. The primary exposure time field in
the Sensor Control Category is in gray text indicating a read only field.
The next steps show how to make changes to the camera and save those changes as
additional cycling preset steps.
Set
cP_PresetConfigurationSelector
to index 2.
Set the feature
cP_ExposureTime
to a higher value, increasing the acquisition brightness.
Repeat for index 3 with an exposure a bit higher again.
