Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_SetFlashStrobe

uEye Camera Manual Version 3.80

is_SetFlashStrobe

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_SetFlashStrobe (HIDS hCam, INT nMode, INT nLine)

Description

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.

Hinweis

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.

Achtung

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

nMode

Flash mode

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

Current setting when used together with
IS_GET_FLASHSTROBE_MODE

Returns the current mode.

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_GetGlobalFlashDelays()
is_SetExternalTrigger()
is_SetTriggerDelay()
is_CaptureVideo()

Code Sample

//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!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com