Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

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. Note that is_SetExternalTrigger() terminates already running image acquisition. You must restart the image acquisition after calling is_SetExternalTrigger().

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.

hint_info

For hardware reasons, the board level versions of the USB uEye LE cameras can only be triggered on the falling edge. The models UI-122xLE Rev. 2 and UI-154xLE Rev. 2 can be triggered on both the rising and falling edges.

hint_info

USB uEye XS have no I/O connector. For UI-1007XS, the is_SetExternalTrigger() function can only be used in combination with the software trigger.

Input parameters

hCam

Camera handle

Return values

When used with
IS_GET_EXTERNALTRIGGER

Returns the current setting

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

IS_INVALID_CAPTURE_MODE

The function can not be executed in the current camera operating mode (free run, trigger or standby).

IS_INVALID_CAMERA_HANDLE

Invalid camera handle

IS_NO_SUCCESS

General error message

IS_SUCCESS

Function executed successfully

Related functions

is_CaptureVideo()

is_FreezeVideo()

is_ForceTrigger()

is_SetTriggerDelay()

is_IO()

is_Trigger()

is_TriggerDebounce()

is_Transfer()

Example

//Enable trigger mode and set high-active flash mode.
is_SetExternalTrigger(hCam, IS_SET_TRIGGER_SOFTWARE);
 
// Set the flash to a high active pulse for each image in the trigger mode
UINT nMode = IO_FLASH_MODE_TRIGGER_HI_ACTIVE;
is_IO(m_hCam, IS_IO_CMD_FLASH_SET_MODE, (void*)&nMode, sizeof(nMode));
 
is_FreezeVideo(hCam, IS_WAIT);

Sample programs

uEye Simple Trigger (C++)

uEye IO (C++)

© 2022 IDS Imaging Development Systems GmbH