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

is_SetExternalTrigger

uEye Camera Manual Version 3.80

is_SetExternalTrigger

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_SetExternalTrigger (HIDS hCam, INT nTriggerMode)

Description

Using is_SetExternalTrigger(), you can activate the trigger mode. If the camera is in standby mode, it quits this mode and activates trigger mode.

In hardware trigger mode, image capture is delayed for each function call until the selected trigger event has occurred.
In software trigger mode, an image is captured immediately when is_FreezeVideo() is called, or a continuous triggered capture is started when is_CaptureVideo() is called. In hardware trigger mode, you can use the is_ForceTrigger() command to trigger an image capture even if no electric signal is present.

When you disable the trigger functionality, you can query the signal level at the trigger input. This option causes the camera to change to freerun mode.

For further information on the image capture modes of the uEye camera, see How To Proceed: Image Capture.

Hinweis

For hardware reasons, the board-level versions of the USB uEye LE cameras can only be triggered on the falling edge.

Achtung

Notes on using the USB uEye XS in trigger mode

The USB uEye XS currently supports the following parameters:
IS_SET_TRIGGER_OFF
IS_SET_TRIGGER_SOFTWARE
IS_GET_SUPPORTED_TRIGGER_MODE
The continuous trigger mode with is_CaptureVideo() is not supported.
Triggered image capture using is_FreezeVideo() with the IS_DONT_WAIT parameter is not supported. Please use the IS_WAIT parameter instead.
In software trigger mode, the exposure time cannot be changed manually.
The delay between software trigger and image capture is higher than with other cameras and can be up to 1 second due to the sensor. If you have enabled auto focus and auto exposure shutter / auto gain control, the image will be captured as soon as adjustment is complete.
Image sizes exceeding 1280 x 720 pixels are only available in software trigger mode.
To disable the software trigger mode, you first need to set an image size that is also available in live mode. Which image sizes are available in a mode can be queried using the is_ImageFormat() function.

Input Parameters

hCam

Camera handle

nTriggerMode

Trigger mode

Trigger event

IS_SET_TRIGGER_OFF

Off

-

IS_SET_TRIGGER_HI_LO

Hardware trigger

Falling signal edge

IS_SET_TRIGGER_LO_HI

Hardware trigger

Rising signal edge

IS_SET_TRIGGER_HI_LO_SYNC

Freerun sync./hardware trigger *)

Falling signal edge

IS_SET_TRIGGER_LO_HI_SYNC

Freerun sync./hardware trigger *)

Rising signal edge

IS_SET_TRIGGER_SOFTWARE

Software trigger

Call of is_FreezeVideo() (single frame mode)

Call of is_CaptureVideo() (continuous mode)

IS_GET_EXTERNALTRIGGER

Returns the trigger mode setting

IS_GET_TRIGGER_STATUS

Returns the current signal level at the trigger input

IS_GET_SUPPORTED_TRIGGER_MODE

Returns the supported trigger modes

Hinweis

*) The freerun synchronization mode is currently only supported by the sensors of the UI-146x-/546x series.

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Current setting when used together with
IS_GET_EXTERNALTRIGGER


When used with
IS_GET_TRIGGER_STATUS

Returns the current signal level at the trigger input

When used with
IS_GET_SUPPORTED_TRIGGER_MODE

Returns the supported modes linked by logical ORs

Related Functions

is_CaptureVideo()
is_FreezeVideo()
is_ForceTrigger()
is_SetTriggerCounter()
is_SetTriggerDelay()
is_SetFlashStrobe()

Code Sample


//Enable trigger mode and set high-active flash mode.

is_SetExternalTrigger (hCam, IS_SET_TRIGGER_SOFTWARE);

is_SetFlashStrobe (hCam, IS_SET_FLASH_HI_ACTIVE, 0);

is_FreezeVideo (hCam, IS_WAIT);

Sample Programs

uEye Simple Trigger (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