 |
 |
|---|---|
USB 3.x GigE |
USB 3.x 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:
•Abfragen und Setzen der Konfiguration für den Zeitstempel. Hierfür wird wahlweise der Trigger-Pin oder einer der beiden GPIOs verwendet.
|
Hinweis: Diese Funktion wird von den folgenden Kamerafamilien unterstützt: •USB 3 uEye CP Rev. 2 •GigE uEye CP Rev. 2 •GigE uEye CP •GigE uEye FA •GigE uEye LE •GigE uEye RE PoE •GigE uEye SE Rev. 4 •GigE uEye SE |
Ü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 |
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
cbSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
Inhalte der Struktur IS_TIMESTAMP_CONFIGURATION
INT |
s32Mode |
Zu setzender Modus: •IS_RESET_TIMESTAMP_ONCE: Setzt den Zeitstempel der Kamera einmalig auf 0 zurück. •IS_IGNORE_PARAMETER: Wird verwendet, wenn Teile einer bereits gesetzten Konfiguration neu gesetzt werden. IS_IGNORE_PARAMETER darf bei der initialen Konfiguration nicht verwendet werden. |
INT |
s32Pin |
Pin über den der Zeitstempel gesetzt wird: •TIMESTAMP_CONFIGURATION_PIN_NONE: Der Zeitstempel wird nicht neu gesetzt. •TIMESTAMP_CONFIGURATION_PIN_TRIGGER: Der Zeitstempel wird bei einem Signal auf dem Trigger-Pin gesetzt. •TIMESTAMP_CONFIGURATION_PIN_GPIO_1: Der Zeitstempel wird bei einem Signal auf GPIO 1 gesetzt. •TIMESTAMP_CONFIGURATION_PIN_GPIO_2: Der Zeitstempel wird bei einem Signal auf GPIO 2 gesetzt. |
INT |
s32Edge |
Der Zeitstempel wird durch eine steigende oder fallende Flanke gesetzt: •TIMESTAMP_CONFIGURATION_EDGE_FALLING •TIMESTAMP_CONFIGURATION_EDGE_RISING |
Statusflags aus DEVICE_FEATURE_MODE_CAPS
IS_DEVICE_FEATURE_CAP_TIMESTAMP_CONFIGURATION |
Konfiguration des Zeitstempels (z.B. Zurücksetzen auf 0 bei einem Signal auf dem Trigger-Pin). |
IS_TIMESTAMP_CONFIGURATION timestampConfiguration;
/* Returns the current timestamp configuration */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_TIMESTAMP_CONFIGURATION,
(void*) ×tampConfiguration, sizeof(timestampConfiguration));
/* A falling edge on the trigger pin will reset the device timestamp once. All 3 parameters will be set at the same time */
timestampConfiguration.s32Mode = IS_RESET_TIMESTAMP_ONCE;
timestampConfiguration.s32Edge = TIMESTAMP_CONFIGURATION_EDGE_FALLING; timestampConfiguration.s32Pin = TIMESTAMP_CONFIGURATION_PIN_TRIGGER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
(void*) ×tampConfiguration, sizeof(timestampConfiguration));
/* Set only the edge */
timestampConfiguration.s32Mode = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Edge = TIMESTAMP_CONFIGURATION_EDGE_RISING;
timestampConfiguration.s32Pin = IS_IGNORE_PARAMETER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
(void*)×tampConfiguration, sizeof(timestampConfiguration));
/* Set only the pin */
timestampConfiguration.s32Mode = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Edge = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Pin = TIMESTAMP_CONFIGURATION_PIN_GPIO_1;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
(void*)×tampConfiguration, sizeof(timestampConfiguration));
/* Set only the mode */
timestampConfiguration.s32Mode = IS_RESET_TIMESTAMP_ONCE;
timestampConfiguration.s32Edge = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Pin = IS_IGNORE_PARAMETER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
(void*)×tampConfiguration, sizeof(timestampConfiguration));
