SetExternalTrigger

Syntax

LONG SetExternalTrigger (LONG nMode)

Description

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 FreezeImage() is called, or a continuous triggered capture is started when StartLiveVideo() is called. In hardware trigger mode, you can use the 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.

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 StartLiveVideo() is not supported.

•Triggered image capture using FreezeImage() 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 IFFormat property.

Parameters

nMode	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 FreezeImage() (single frame mode) Call of StartLiveVideo() (continuous mode)

*1 The freerun synchronization mode is currently only supported by the sensors of the UI-146x/UI-546x series. For more information please refer to the uEye Manual.

Return values

IS_SUCCESS	Function executed successfully
IS_NO_SUCCESS	General error message

Example:

//Activate the external trigger input and activate
//the FlashStrobe to use the High Level as active one.
//Configure the Camera to raise the Flash signal 31320µs
//after the exposure has started and take only 1560µs.
//Finally capture an image and wait a maximum of 2 seconds
//for the external trigger signal:
dExpRet = SetExposureTime(32.565);
ret = SetExternalTigger(1);
ret = SetFlashStrobe(2);
ret = SetFlashDelay(31320);
ret = SetFlashDuration(1560);
ret = FreezeImage(2000);

Related functions

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > Function descriptions >	History back Previous chapter Next chapter Print
SetExternalTrigger