USB 3.0	USB 3.0

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:

•Beim Modell UI-3013XC: Hohen Dynamikumfang aktivieren, siehe USB 3 uEye XC Kamera öffnen.

Mit diesem speziellen Modus können Sie Bilder mit einem höheren Dynamikumfang erfassen. Dadurch können mehr Details sowohl in dunklen als auch hellen Bildbereichen dargestellt 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_WIDE_DYNAMIC_RANGE_MODE Aktivierte/deaktiviert den hohen Dynamikumfang: •1: Aktiviert den hohen Dynamikumfang •0: Deaktiviert den hohen Dynamikumfang IS_DEVICE_FEATURE_CMD_GET_WIDE_DYNAMIC_RANGE_MODE Gibt die aktuelle Einstellung zurück (Beispiel) IS_DEVICE_FEATURE_CMD_GET_WIDE_DYNAMIC_RANGE_MODE_DEFAULT Gibt die Standardeinstellung zurück.
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

// Enable wide dynamic range mode
int nMode = 1;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_WIDE_DYNAMIC_RANGE_MODE, &nMode, sizeof(nMode));
 
// Get current mode
int nMode;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_WIDE_DYNAMIC_RANGE_MODE, &nMode, sizeof(nMode));
if (nMode == 1)
{
  // Wide dynamic mode is enabled
}