USB 3.0 GigE	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:

•Referenzspalten für den Schwarzwert aktivieren/deaktivieren, siehe uEye Cockpit: Fortgeschritten

•Referenzzeilen für den Schwarzwert aktivieren/deaktivieren, siehe uEye Cockpit: Fortgeschritten

Die Schwarzwert-Referenz wird derzeit von den folgenden Modellen unterstützt: •UI-300x (Referenzzeilen) •UI-304x/UI-504x (Referenzzeilen) •UI-306x (Referenzzeilen) •UI-308x (Referenzzeilen) •UI-309x (Referenzzeilen) •UI-313x/UI-513x (Referenzzeilen) •UI-314x/UI-514x (Referenzzeilen) •UI-316x (Referenzzeilen) •UI-318x (Referenzzeilen) •UI-320x/UI-520x (Referenzzeilen) •UI-326x/UI-526x (Referenzzeilen) •UI-329x/UI-529x (Referenzzeilen) •UI-336x/UI-536x (Referenzspalten) •UI-337x/UI-537x (Referenzspalten)

Ü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_BLACK_REFERENCE_MODE_DEFAULT Gibt die Standardeinstellung für die Schwarzwert-Referenz zurück IS_DEVICE_FEATURE_CMD_GET_BLACK_REFERENCE_MODE Gibt die aktuelle Einstellung für die Schwarzwert-Referenz zurück (Beispiel) IS_DEVICE_FEATURE_CMD_SET_BLACK_REFERENCE_MODE Setzt die Einstellung für die Schwarzwert-Referenz: •IS_BLACK_REFERENCE_MODE_OFF: Deaktiviert die Schwarzwert-Referenzspalten •IS_BLACK_REFERENCE_MODE_COLUMNS_LEFT: Aktiviert die Schwarzwert-Referenzspalten (linke Bildseite) •IS_BLACK_REFERENCE_MODE_ROWS_TOP: Aktiviert die Schwarzwert-Referenzzeile (oben)
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

UINT nMode = 0;
 
/* Get current black reference mode */
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_BLACK_REFERENCE_MODE, (void*)&nMode,
                          sizeof(nMode));
 
/* Get supported black reference mode(s) */
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_BLACK_REFERENCE_MODES,
                          (void*)&nMode, sizeof(nMode));
 
/* Set the Black reference mode according to the supported mode */
if (IS_BLACK_REFERENCE_MODE_COLUMNS_LEFT == nMode)
{
  /* Enable black reference mode left columns */
  nMode = IS_BLACK_REFERENCE_MODE_COLUMNS_LEFT;
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_BLACK_REFERENCE_MODE, (void*)&nMode,
                          sizeof(nMode));
}
else if (IS_BLACK_REFERENCE_MODE_ROWS_TOP == nMode)
{
  /* Enable black reference mode top rows */
  nMode = IS_BLACK_REFERENCE_MODE_ROWS_TOP;
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_BLACK_REFERENCE_MODE, (void*)&nMode,
                          sizeof(nMode));
}