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:

•Analoge Sensorgrundverstärkung setzen, siehe uEye Cockpit: Fortgeschritten.

Die analoge Sensorgrundverstärkung wird derzeit von den folgenden Modellen unterstützt: •UI-300x •UI-304x/UI-504x •UI-307x •UI-308x •UI-309x •UI-313x/UI-513x •UI-314x/UI-514x •UI-316x •UI-318x •UI-320x/UI-520x •UI-327x/UI-527x •UI-328x/UI-528x •UI-329x/UI-529x •UI-336x/UI-536x •UI-337x/UI-537x •UI-386x/UI-586x •UI-388x/UI-588x

Ü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_GET_SENSOR_SOURCE_GAIN_RANGE Gibt den Einstellbereich für die analoge Sensorgrundverstärkung zurück. Der Wert kann auch negativ sein. Default = 0 (Beispiel) IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_DEFAULT Gibt den Standardwert für die analoge Sensorgrundverstärkung zurück IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN Gibt die aktuell eingestellte analoge Sensorgrundverstärkung zurück IS_DEVICE_FEATURE_CMD_SET_SENSOR_SOURCE_GAIN Setzt die analoge Sensorgrundverstärkung
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

INT nGain = 0;
 
/* Get sensor source gain range */
IS_RANGE_S32 rangeSourceGain;
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_RANGE,
                          (void*)&rangeSourceGain, sizeof(rangeSourceGain));
 
if (nRet == IS_SUCCESS)
{
/* Set sensor source gain to max */
nGain = rangeSourceGain.s32Max;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_SENSOR_SOURCE_GAIN,
                        (void*)&nGain, sizeof(nGain));
}
 
/* Get default sensor source gain */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_DEFAULT,
                      (void*)&nGain, sizeof(nGain));
 
/* Get the current sensor source gain */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN,
                      (void*)&nGain, sizeof(nGain));