USB 3.1 Gen 1 USB 3.0 GigE	USB 3.1 Gen 1 USB 3.0 GigE

Syntax

INT is_DeviceFeature (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Beschreibung

Mit is_DeviceFeature() können kameraspezifische Funktionen einiger uEye-Modelle konfiguriert werden:

•Die Verwendung des pegelgesteuerten Triggers aktivieren/deaktivieren, siehe uEye Cockpit: Fortgeschritten

Der pegelgesteuerte Trigger wird derzeit von den folgenden Modellen unterstützt: •UI-300x •UI-304x •UI-306x •UI-307x •UI-308x •UI-309x •UI-320x/UI-520x •UI-326x/UI-526x •UI-327x/UI-527x •UI-328x/UI-528x •UI-329x/UI-529x Beachten Sie, dass der pegelgesteuerte Trigger von den uEye LE Kamerafamilien nicht unterstützt wird.

Durch die Verwendung des pegelgesteuerten Triggers kann direkt über die Dauer des Triggersignals die Belichtungsdauer gesteuert werden.

Der pegelgesteuerte Trigger kann nicht zusammen mit dem Software-Triggermodus, Trigger-Vorteiler oder IDS Linescan ("AOI-Merge-Modus") verwendet werden.

Ü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 cbSizeOfParam angegeben.

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_DEVICE_FEATURE_CMD_SET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE Aktiviert/Deaktiviert die Verwendung des pegelgesteuerten Triggers (Beispiel): •1 = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_ON: Aktiviert den pegelgesteuerten Trigger •0 = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_OFF: Deaktiviert den pegelgesteuerten Trigger IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE Gibt den aktuellen Status für den pegelgesteuerten Trigger zurück (Beispiel). IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE_DEFAULT Gibt die Standardeinstellung für den pegelgesteuerten Trigger zurück (Beispiel).
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Statusflags aus DEVICE_FEATURE_MODE_CAPS

Beispiel

/* Query the current settings */
INT nMode = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_OFF;
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE,
                          (void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
if (IS_LEVEL_CONTROLLED_TRIGGER_INPUT_OFF == nMode)
{
  /* Level controlled trigger is disabled */
}
else if (IS_LEVEL_CONTROLLED_TRIGGER_INPUT_ON == nMode)
{
  /* Level controlled trigger is enabled */
}
}
 
/* Enable level controlled trigger */
nMode = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_ON;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE,
                      (void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
/* Level controlled trigger is enabled */
}
 
/* Get default setting */
nRet = is_DeviceFeature(hCam,
                       IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE_DEFAULT,
                      (void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
  /* nMode returns the default setting */
}