Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 3.x

GigE

USB 3.x

GigE

Syntax

INT is_TriggerDebounce (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)

Description

Using is_TriggerDebounce(), you can suppress disturbances at the trigger input when you are running a uEye camera in trigger mode. (This function cannot be used if GPIO is used for triggering.) The signal at the trigger input is only recognized as a trigger if the signal level remains constant at the target level for a user-selectable time. The signal edge and a delay (DELAY_TIME) can be set as parameters. It is recommend to use automatic signal edge selection.

Example: Mode set to "rising edge" (TRIGGER_DEBOUNCE_MODE_RISING_EDGE) and delay set to 50 µs. The camera will not trigger the image capture on the rising edge until the digital signal has remained at the high level for longer than 50 µs without interruption. If this is not the case, the signal is regarded as a disturbance and ignored.

The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a variable of the UINT type. The size of the memory area to which pParam refers is specified in the nSizeOfParam input parameter.

hint_attention

is_TriggerDebounce() delays the start of a triggered image capture by the selected time (DELAY_TIME).

hint_info

This function is currently only supported by the USB 3 and GigE uEye camera series but not by the UI-359xLE camera model or the uEye LE USB 3.1 Gen 1 camera family.

Input parameters

hCam

Camera handle

pParam

Pointer to a function parameter, whose function depends on nCommand.

nSizeOfParam

Size (in bytes) of the memory area to which pParam refers.

Function modes

TRIGGER_DEBOUNCE_MODE_NONE

Disables debouncing the trigger input.

TRIGGER_DEBOUNCE_MODE_FALLING_EDGE

Debounces the trigger input for falling edge signals.

TRIGGER_DEBOUNCE_MODE_RISING_EDGE

Debounces the trigger input for rising edge signals.

TRIGGER_DEBOUNCE_MODE_BOTH_EDGES

Debounces the trigger input for rising or falling edge signals.

TRIGGER_DEBOUNCE_MODE_AUTOMATIC

Debounces the trigger input with automatic edge selection (recommended). The edge is selected based on the set trigger edge (see is_SetExternalTrigger()).

Return values

IS_CANT_COMMUNICATE_WITH_DRIVER

Communication with the driver failed because no driver has been loaded.

IS_CANT_OPEN_DEVICE

An attempt to initialize or select the camera failed (no camera connected or initialization error).

IS_INVALID_CAMERA_HANDLE

Invalid camera handle

IS_INVALID_PARAMETER

One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.

IS_IO_REQUEST_FAILED

An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

The camera model used here does not support this function or setting.

IS_SUCCESS

Function executed successfully

Related functions

is_SetExternalTrigger()

is_SetTriggerDelay()

Example

INT value = TRIGGER_DEBOUNCE_MODE_RISING_EDGE;
INT nRet = is_TriggerDebounce(hCam, TRIGGER_DEBOUNCE_CMD_SET_MODE, (void*)&value, sizeof(value));
if(IS_SUCCESS != nRet)
{
    // handle error here
}

© 2022 IDS Imaging Development Systems GmbH