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.
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. |
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 |
Returns the current setting |
When used with |
Returns the current signal level at the trigger input |
When used with |
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
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++)