|
|
USB 2.0
GigE
|
USB 2.0
GigE
|
Syntax
INT is_SetFlashStrobe (HIDS hCam, INT nMode, INT nLine)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_IO() function instead (see also Obsolete functions).
|
|
is_SetFlashStrobe() controls the uEye's digital outputs and defines the flash strobe behavior. The digital outputs can be used in both freerun mode and trigger mode. You can synchronize the output level to the exposure time or set it statically.
For details on flash timing, see the Digital input/output (trigger/flash) and Operating modes chapters.
|
Note on duration and trigger delay
You can set the flash duration and flash delay using the is_SetFlashDelay() function. The is_GetGlobalFlashDelays() returns the values required for precisely synchronizing the flash signal to the current timing settings.
|
|
|
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.
|
|
Input parameters
hCam
|
Camera handle
|
Flash strobe with exposure time synchronization
|
IS_SET_FLASH_OFF
|
Disables the digital output.
|
IS_SET_FLASH_LO_ACTIVE
|
Enables the flash strobe in trigger mode.
LO_ACTIVE: The digital output is set to low level for the flash duration.
|
IS_SET_FLASH_HI_ACTIVE
|
Enables the flash strobe in trigger mode.
HI_ACTIVE: The digital output is set to high level for the flash duration.
|
IS_SET_FLASH_LO_ACTIVE_FREERUN
|
Enables the flash strobe in freerun mode.
LO_ACTIVE: The digital output is set to low level for the flash duration.
|
IS_SET_FLASH_HI_ACTIVE_FREERUN
|
Enables the flash strobe in freerun mode.
HI_ACTIVE: The digital output is set to high level for the flash duration.
|
IS_GET_FLASHSTROBE_MODE
|
Returns the current mode.
|
IS_SET_FLASH_IO_1
|
Additionally enables the flash strobe via the first general purpose I/O (GPIO 1) if supported by the camera model.
|
IS_SET_FLASH_IO_2
|
Additionally enables the flash strobe via the second general purpose I/O (GPIO 2) if supported by the camera model.
|
IS_GET_SUPPORTED_FLASH_IO_PORTS
|
Returns which of the general purpose I/Os (GPIO) can be used for the flash strobe
|
Statically setting the output level
|
IS_SET_FLASH_HIGH
|
Statically sets the digital output to high level (HIGH).
|
IS_SET_FLASH_LOW
|
Statically sets the digital output to low level (LOW).
|
|
nLine
|
Currently not used
|
Return values
IS_SUCCESS
|
Function executed successfully
|
IS_NO_SUCCESS
|
General error message
|
When used with
IS_GET_FLASHSTROBE_MODE
|
Current setting
|
When used with
IS_GET_SUPPORTED_FLASH_IO_PORTS
|
Returns the supported ports linked by a logical OR.
IS_SET_FLASH_IO_1
IS_SET_FLASH_IO_2
|
Related functions
•is_SetFlashDelay()
•is_IO()
•is_SetExternalTrigger()
•is_SetTriggerDelay()
•is_CaptureVideo()
Example
//Software trigger mode, HI_ACTIVE flash mode
is_SetExternalTrigger (hCam, IS_SET_TRIGGER_SOFTWARE);
is_SetFlashStrobe (hCam, IS_SET_FLASH_HI_ACTIVE, 0);
is_FreezeVideo (hCam, IS_WAIT);
// Flash additionally on second GPIO output
is_SetFlashStrobe (hCam, IS_SET_FLASH_HI_ACTIVE | IS_SET_FLASH_IO_2, 0);
// Flash only on normal flash output
is_SetFlashStrobe (hCam, IS_SET_FLASH_HI_ACTIVE, 0);
Sample programs
•uEye Flash Strobe (C++)
•uEye IO (C++)
Suggestion for improvement? Send us your short Feedback on this chapter.
Thank you very much!