IDS Peak comfortSDK, genericSDK, IPL, and AFL developer manuals are external documents. Please contact us if you need them.
The majority of IDS Vision models have digital outputs that can be used for flash control.
It is recommended to use the FlashControl feature to generate a "FlashActive" signal, if your camera model supports it.
Note on I/O pinning and circuits For I/O pin assignment and circuit information for your camera model, refer to the technical manual of the respective camera family. |
The initial setting for the flash output is LOW active (LineStatus = "False").
Configuration
The FlashControl feature accepts different sources as FlashReference. Default is the "ExposureActive" signal. Timing for global and rolling shutter sensors differs.
Make sure "ExposureActive" is selected as FlashReference.
FlashReference = ExposureActive;
Now select the "FlashActive" signal as source for your output line, here a GPIO.
LineSelector = Line2;
LineMode = Output;
LineSource = FlashActive;
Note for uEye cameras: If you want to apply a flash signal to a GPIO, you must set "Line1Signal" as LineSource for the GPIO (Line2 or Line3) and configure Line1 as a flash. |
Alternatives and variations: Global flash window
With rolling shutter sensors, the "FlashActive" signal can also refer to the "GlobalFlashWindow". This is the short period, when all sensor rows are exposed. For using the "GlobalFlashWindow", you have to select an ExposureTime that is long enough for the last row to start while the first one is still open.
Just select "GlobalFlashWindow" as FlashReference and configure your output line as usual.
FlashReference = GlobalFlashWindow;
Now select the "FlashActive" signal as source for your output line, here a GPIO.
LineSelector = Line2;
LineMode = Output;
LineSource = FlashActive;
Alternatives and variations: Start and end delays
You can adjust the start and end of the "FlashActive" signal relative to its reference using FlashStartDelay and FlashEndDelay. Some camera models, allow for negative delays. This way, you can not only define time offsets, but you can also shrink or expand the flash signal.
The ranges of FlashStartDelay and FlashEndDelay mainly depend on: •type of acquisition (triggered or freerun) |
Adding delays to the start and end of the "FlashActive" signal by defining FlashStartDelay and FlashEndDelay (in microseconds). Here the example for shrinking.
FlashStartDelay = 20.0;
FlashEndDelay = -100.0;
Alternatives and variations: Flash with specific duration
You can define a flash with a specific duration using the Timer feature.
TimerSelector = Timer0;
TimerTriggerSource = ExposureStart;
TimerDuration = 50.0;
TimerDelay = 20.0;
Use the "Timer0Active" signal on the output line.
LineSelector = Line2;
LineMode = Output;
LineSource = Timer0Active;
Alternatives and variations: "ExposureActive" as LineSource
Using "ExposureActive" as LineSource is the most trivial case and a fall-back if your camera model does not support Flash Control or Timer Control. There are no additional configuration possibilities in this case, except inverting the signal or applying a LineNoiseFilterEnable (if available).
LineSelector = Line2;
LineMode = Output;
LineSource = ExposureActive;
Additional information
Camera operation |
|
---|---|
Camera feature reference |