is_SetExternalTrigger

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.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*1	Falling signal edge
IS_SET_TRIGGER_LO_HI_SYNC	Freerun sync./hardware trigger*1	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

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

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