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-325x: Steuern des Multi-Integration-Modus, siehe uEye Cockpit: Shutter. Der Multi-Integration-Modus kann nur im getriggerten Betrieb verwendet werden.

Hinweis: Wechseln Sie mit is_SetExternalTrigger() in den Trigger-Modus, bevor Sie den Multi-Integration-Modus aktivieren.

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

Hinweis: Wenn Sie is_ResetToDefault() verwenden, um die Kamera auf die Standardwerte zurückzusetzen, wird der Multi-Integration-Modus deaktiviert. Auch wird dieser Modus nicht in der uEye Parameterdatei (ini-Datei) für die Kamera gespeichert.

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_SCOPE Gibt eine Struktur mit den minimal und maximal möglichen Einstellbereichen im Multi-Integration-Modus zurück (Beispiel). IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_PARAMS Gibt die eingestellten Parameter im Multi-Integration-Modus zurück. IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_SET_PARAMS Setzt die Parameter im Mutli-Integration-Modus. IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_MODE_DEFAULT Gibt die Standardeinstellung des Multi-Integration-Modus zurück. IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_MODE Gibt die aktuelle Einstellung des Multi-Integration-Modus zurück. IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_SET_MODE Setzt den Multi-Integration-Modus: •MULTI_INTEGRATION_MODE_OFF: Deaktiviert den Multi-Integration-Modus •MULTI_INTEGRATION_MODE_SOFTWARE: Der Multi-Integration-Modus wird softwareseitig gesteuert. In dieser Variante wird die Belichtungssequenz von der kamerainternen Pulsweitenmodulation (PWM) erzeugt. In diesem Modus wirken sich die Parametereinstellungen aus. •MULTI_INTEGRATION_MODE_GPIO1: Setzt den Multi-Integration-Modus auf GPIO 1. Die Belichtungssequenz wird vom Benutzer an den GPIO 1-Eingang gelegt. In diesem Modus haben die Parameter keine Bedeutung. •MULTI_INTEGRATION_MODE_GPIO2: Setzt den Multi-Integration-Modus auf GPIO 2. Die Belichtungssequenz wird vom Benutzer an den GPIO 2-Eingang gelegt. In diesem Modus haben die Parameter keine Bedeutung.
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

Inhalte der Struktur IS_MULTI_INTEGRATION_CYCLES

Inhalte der Struktur IS_MULTI_INTEGRATION_SCOPE

Beispiel

/* Switch into trigger mode before activating multi integration mode */
INT nRet = is_SetExternalTrigger(m_hCam, IS_SET_TRIGGER_SOFTWARE);

 
/* Get the scope for the multi integration params */
IS_MULTI_INTEGRATION_SCOPE scopeMIM;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_SCOPE, (void*)&scopeMIM, sizeof(scopeMIM));
if (nRet == IS_SUCCESS)
{
double dblMinIntegration_ms = scopeMIM.dblMinIntegration_ms;
...
}
 
/* Init the multi integration params */
IS_MULTI_INTEGRATION_CYCLES * mimCycles =
new IS_MULTI_INTEGRATION_CYCLES[scopeMIM.nMaxNumberOfCycles](); /* Always use maximum available number */
 
mimCycles[0].dblIntegration_ms = 0.0010; /* 1 us high */
mimCycles[0].dblPause_ms = 0.0150; /* 15 us pause */
mimCycles[1] ...
...
 
/* Set the multi integration params */
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_SET_PARAMS, (void*)mimCycles, m_sScope.nMaxNumberOfCycles * sizeof(IS_MULTI_INTEGRATION_CYCLES));
 
/* Read back the multi integration params */
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_PARAMS, (void*)mimCycles, m_sScope.nMaxNumberOfCycles * sizeof(IS_MULTI_INTEGRATION_CYCLES));
 
/* Get the default value for the multi integration mode */
UINT u32Mode;

nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_MODE_DEFAULT, (void*)&u32Mode, sizeof(u32Mode));
 
/* Get the current multi integration mode */
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_GET_MODE, (void*)&u32Mode, sizeof(u32Mode));
 
/* Set a new mode */
u32Mode = MULTI_INTEGRATION_MODE_SOFTWARE;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_MULTI_INTEGRATION_SET_MODE, (void*)&u32Mode, sizeof(u32Mode));