Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_TriggerDebounce

uEye Camera Manual Version 3.80

is_TriggerDebounce

Windows_Logo

Linux_Logo

GigE

GigE

Syntax

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

Description

Using is_TriggerDebounce(), you can suppress disturbances at the digital input when you are running a GigE uEye camera in trigger mode. The signal at the digital 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.

Achtung

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

Hinweis

This function is currently only supported by the GigE uEye camera series.

Input Parameters

hCam

Camera handle

nCommand

 

Setting the function mode

TRIGGER_DEBOUNCE_CMD_GET_SUPPORTED_MODES

Returns the function modes supported by the camera.

More details

pParam: Pointer to a bit mask of type UINT
The bit mask returns the supported modes, linked by logical ORs (see Function Modes table).

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_SET_MODE

Sets a function mode.

More details

pParam: Pointer to variable of type UINT that passes the value to be set.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_MODE

Returns the set function mode.

More details

pParam: Pointer to variable of type UINT returning the current value.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_MODE_DEFAULT

Returns the default mode.

More details

pParam: Pointer to variable of type UINT returning the default value.

nSizeOfParam: 4

Setting the delay time

TRIGGER_DEBOUNCE_CMD_SET_DELAY_TIME

Sets a delay time.

More details

pParam: Pointer to variable of type UINT that passes the value to be set.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_DELAY_TIME

Returns the set delay time.

More details

pParam: Pointer to variable of type UINT returning the current value.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_DELAY_TIME_MIN

Returns the minimum value for the delay.

More details

pParam: Pointer to variable of type UINT returning the minimum value.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_DELAY_TIME_MAX

Returns the maximum value for the delay.

More details

pParam: Pointer to variable of type UINT returning the maximum value.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_DELAY_TIME_INC

Returns the increment for setting the delay.

More details

pParam: Pointer to variable of type UINT returning the increment.

nSizeOfParam: 4

TRIGGER_DEBOUNCE_CMD_GET_DELAY_TIME_DEFAULT

Returns the default value for the delay.

More details

pParam: Pointer to variable of type UINT returning the default value.

nSizeOfParam: 4

pParam

Pointer to a function parameter; which function parameter is referred to here depends on nCommand.

nSizeOfParam

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

Function Modes

TRIGGER_DEBOUNCE_MODE_NONE

Disables debouncing the digital input.

TRIGGER_DEBOUNCE_MODE_FALLING_EDGE

Debounces the digital input for falling edge signals.

TRIGGER_DEBOUNCE_MODE_RISING_EDGE

Debounces the digital input for rising edge signals.

TRIGGER_DEBOUNCE_MODE_BOTH_EDGES

Debounces the digital input for rising or falling edge signals.

TRIGGER_DEBOUNCE_MODE_AUTOMATIC

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

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_INVALID_PARAMETER

One of the parameters passed is invalid

IS_NOT_SUPPORTED

This function is not supported by the current camera

Related Functions

is_SetExternalTrigger()
is_SetTriggerDelay()

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


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com