Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_SetExternalTrigger |
uEye Camera Manual Version 3.80
is_SetExternalTrigger
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.
|
|
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 |
|
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
Current setting when used together with |
|
When used with |
Returns the current signal level at the trigger input |
When used with |
Returns the supported modes linked by logical ORs |
Related Functions
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++) |