 |
 |
|---|---|
USB 3.x GigE |
USB 3.x GigE |
Syntax
INT is_TriggerDebounce (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)
Beschreibung
Mit is_TriggerDebounce()können bei uEye Kameras im Triggermodus am Trigger-Eingang Störungen unterdrückt werden. (Diese Funktion kann nicht verwendet werden, wenn per GPIO getriggert wird.) Ein Signal am Trigger-Eingang wird dann erst als Trigger erkannt, wenn der Signalpegel während einer einstellbaren Zeit auf dem Zielpegel konstant bleibt. Als Parameter können die Signalflanke sowie eine Verzögerungszeit (DELAY_TIME) eingestellt werden. Es wird empfohlen, die automatische Wahl der Signalflanke zu verwenden.
Beispiel: Als Modus wird "Steigende Flanke" (TRIGGER_DEBOUNCE_MODE_RISING_EDGE) gewählt, als Verzögerungszeit 50 µs. Die Kamera löst eine getriggerte Bildaufnahme über die steigende Flanke erst aus, wenn das digitale Signal länger als 50 µs ohne Unterbrechung auf dem High-Pegel bleibt. Andernfalls wird das Signal als Störung gewertet und ignoriert.
Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter nSizeOfParam angegeben.
|
is_TriggerDebounce() verzögert den Start der getriggerten Bildaufnahme um die eingestellte Zeit (DELAY_TIME). |
|
Diese Funktion wird derzeit nur von USB 3 und GigE uEye Kameras unterstützt aber nicht von dem Kameramodell UI-359xLE oder der Kamerafamilie uEye LE USB 3.1 Gen 1. |
Übergabeparameter
hCam |
Handle auf Kamera |
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
nSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
TRIGGER_DEBOUNCE_MODE_NONE |
Entprellung des Trigger-Eingangs deaktiviert. |
TRIGGER_DEBOUNCE_MODE_FALLING_EDGE |
Entprellung des Trigger-Eingangs für Signale mit fallender Flanke. |
TRIGGER_DEBOUNCE_MODE_RISING_EDGE |
Entprellung des Trigger-Eingangs für Signale mit steigender Flanke. |
TRIGGER_DEBOUNCE_MODE_BOTH_EDGES |
Entprellung des Trigger-Eingangs für Signale mit steigender oder fallender Flanke. |
TRIGGER_DEBOUNCE_MODE_AUTOMATIC |
Entprellung des Trigger-Eingangs mit automatischer Wahl der Flanke (empfohlen). Die Flanke wird identisch zur eingestellten Triggerflanke gewählt (siehe is_SetExternalTrigger()). |
Rückgabewerte
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
IS_IO_REQUEST_FAILED |
Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
Beispiel
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
}
