The Flash class provides methods for controlling all flash functions.
•Rolling shutter cameras:
Using Flash, you can determine the times required to implement a global flash function for rolling shutter cameras. This way, a rolling shutter camera can also be used as a global shutter camera provided that no ambient light falls on the sensor outside the flash period.
If the exposure time is set too short so that no global flash operation is possible, the method returns uEye.Defines.Status.NO_SUCCESS.
•Rolling shutter cameras with global start function:
To use a rolling shutter camera with the global start function, first call Get(). Otherwise, incorrect values will be returned for delay and duration.
•Global shutter cameras:
In freerun mode, the exposure of global shutter cameras is delayed if the exposure time is not set to the maximum value. Flash determines the required delay in order to synchronize exposure and flash operation. In triggered mode, the return values for delay and flash duration are 0, since no delay is necessary before exposure starts.
For further information, please refer to the chapters Camera basics: "Shutter methods", "Digital input/output (trigger/flash)" and "Operating modes" in the uEye manual.
If you operate the camera in burst trigger mode, the flash settings can only be changed after the burst is completed.
Note: The uEye LE USB 3.1 Gen 1 camera family supports flash only in triggered mode and not in freerun mode. |
Note on the accuracy of flash synchronization
The following parameters have an influence on the camera's internal timing:
•Image geometry (CMOS and CCD sensors)
•Pixel clock (CMOS and CCD sensors)
•Exposure time (CCD sensors)
If you change any of these parameters, you will have to set the flash duration and flash delay parameters once again.
Note on the delay time and optocouplers Depending on the set edge delays are possible in the lower µs range with built-in optocouplers. So, for example the set flash duration varies from the measured flash duration. This delay should be considered for very small exposure times because the flash is fired with delay. |
Methods
Method |
Description |
---|---|
Returns the parameters for the global exposure window and sets them as flash parameters. |
|
Returns the default auto flash setting in freerun mode. |
|
Returns the current auto flash setting in freerun mode. |
|
Returns the range for flash delay. |
|
Returns the range for flash duration. |
|
Returns the parameters for the global exposure window. |
|
Returns the minimum possible values for flash delay and flash duration. |
|
Returns the current flash mode. |
|
Returns the current values for flash delay and duration. |
|
Returns the GPIOs which can be used for flash output. |
|
Enables/disables the auto flash in freerun mode. |
|
Sets the flash delay and flash duration and allows the minimum values for GPIOs. |
|
Sets the flash mode. |
|
Sets the values for flash delay and duration. |