Aktivieren Sie JavaScript, um die Website anzuzeigen.

IDS Software Suite 4.95

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

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:

IDS Linescan ("AOI-Merge-Modus") konfigurieren

FPN-Korrektur setzen

JPEG-Kompression setzen

Bildeffekte verwenden

I2C-Stop-Bit setzen

Log-Modus verwenden

Multi-Integration-Modus verwenden

Kamera-LUT mit RAW-Format verwenden

Pegelgesteuerten Trigger verwenden

Erweiterten Pixeltakt verwenden

Schwarzwert-Referenz anzeigen

Sensor-Bittiefe setzen

Sensorgrundverstärkung setzen

Sensor-Temperatur auslesen

Shutter-Modus umschalten

Temperaturstatus abfragen

Internen Bildspeicher verwenden

Zeilenmodus verwenden

Zeitstempel konfigurieren

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

Statusflags aus DEVICE_FEATURE_MODE_CAPS

IS_DEVICE_FEATURE_CAP_BLACK_REFERENCE

Zeigt die Schwarzwert-Referenz im Bild an, mit denen der Schwarzwert kalibriert werden kann.

IS_DEVICE_FEATURE_CAP_END_OF_EXPOSURE

Das Kameramodell unterstützt das Event IS_SET_EVENT_END_OF_EXPOSURE (siehe is_Event())

IS_DEVICE_FEATURE_CAP_EXTENDED_PIXELCLOCK_RANGE

Die Verwendung des erweiterten Pixeltaktbereichs wird unterstützt.

IS_DEVICE_FEATURE_CAP_FPN_CORRECTION

Fixed-Pattern-Noise-Korrektur wird unterstützt.

IS_DEVICE_FEATURE_CAP_IMAGE_EFFECT

Bildeffekte werden unterstützt.

IS_DEVICE_FEATURE_CAP_JPEG_COMPRESSION

JPEG-Kompression wird unterstützt.

IS_DEVICE_FEATURE_CAP_LEVEL_CONTROLLED_TRIGGER

Die Verwendung des pegelgesteuerten Triggers wird unterstützt.

IS_DEVICE_FEATURE_CAP_LINESCAN_MODE_FAST

Schnellen Zeilenmodus wird unterstützt/Modus setzen

IS_DEVICE_FEATURE_CAP_LINESCAN_NUMBER

Zeilennummer im schnellen Zeilenmodus wird unterstützt/Nummer setzen

IS_DEVICE_FEATURE_CAP_LOG_MODE

Log-Modus wird unterstützt/Modus setzen.

IS_DEVICE_FEATURE_CAP_MEMORY_MODE

Interner Bildspeicher wird unterstützt.

IS_DEVICE_FEATURE_CAP_MULTI_INTEGRATION

Der Multi-Integration-Modus wird unterstützt.

IS_DEVICE_FEATURE_CAP_NOISE_REDUCTION

Rauschunterdrückung wird unterstützt.

IS_DEVICE_FEATURE_CAP_REPEATED_START_CONDITION_I2C

Das Ein-/Ausschalten des I2C-Stop-Bit beim Lesebefehl wird unterstützt.

IS_DEVICE_FEATURE_CAP_SENSOR_BIT_DEPTH

Stellt die Bittiefe des Sensors ein. Mit der Einstellung IS_SENSOR_BIT_DEPTH_AUTO wählt die Software automatisch die passende Sensor-Bittiefe zum gewählten Bildformat. Diese Bittiefe kann aber auch unabhängig vom Bildformat direkt gewählt werden.

Achtung: Da hier Kombinationen gewählt werden können, die keinen Sinn ergeben, sollte dieses Funktion nur von Experten verwendet werden. In den meisten Fällen kann die Autoeinstellung beibehalten werden.

IS_DEVICE_FEATURE_CAP_SENSOR_SOURCE_GAIN

Analoge Sensorgrundverstärkung wird unterstützt.

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_GLOBAL

Global-Shutter-Modus wird unterstützt/Modus setzen

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_GLOBAL_ ALTERNATIVE_TIMING

Global-Shutter-Modus mit anderen Timing-Parametern wird unterstützt/Modus setzen

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_ROLLING

Rolling-Shutter-Modus wird unterstützt/Modus setzen

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_ROLLING_ GLOBAL_START

Rolling-Shutter-Modus mit Global-Start wird unterstützt/Modus setzen

IS_DEVICE_FEATURE_CAP_TEMPERATURE

Anzeige der internen Kameratemperatur wird unterstützt.

IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS

Überwachung des Temperaturstatus wird unterstützt.

IS_DEVICE_FEATURE_CAP_TIMESTAMP_CONFIGURATION

Konfiguration des Zeitstempels (z.B. Zurücksetzen des Zeitstempel auf 0 bei einem Signal auf dem Trigger-Pin).

IS_DEVICE_FEATURE_CAP_VERTICAL_AOI_MERGE

Spezieller AOI-Merge-Modus, der die Zeilen einer AOI zu einem neuen Bild zusammenfügt.

IS_DEVICE_FEATURE_CAP_WIDE_DYNAMIC_RANGE

Die Verwendung des hohen Dynamikumfangs wird unterstützt.

Rückgabewerte

IS_CANT_COMMUNICATE_WITH_DRIVER

Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist.

IS_CANT_OPEN_DEVICE

Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren).

IS_INVALID_CAPTURE_MODE

Die Funktion kann im aktuellen Betriebsmodus der Kamera (Freilaufend, Trigger oder Standby) nicht ausgeführt werden.

IS_INVALID_CAMERA_HANDLE

Ungültiges Kamera-Handle

IS_INVALID_PARAMETER

Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich.

IS_IO_REQUEST_FAILED

Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen.

IS_NO_SUCCESS

Allgemeine Fehlermeldung

IS_NOT_SUPPORTED

Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.

IS_OUT_OF_MEMORY

Es konnte kein Speicher alloziert werden.

IS_SUCCESS

Funktion erfolgreich

Beispiel

INT nSupportedFeatures;
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_FEATURES,
                          (void*)&nSupportedFeatures, sizeof(nSupportedFeatures));
if (nRet == IS_SUCCESS)
{
if (nSupportedFeatures & IS_DEVICE_FEATURE_CAP_LINESCAN_MODE_FAST)
{
  // Enable line scan mode
  INT nMode = IS_DEVICE_FEATURE_CAP_LINESCAN_MODE_FAST;
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_LINESCAN_MODE, (void*)&nMode,
                          sizeof(nMode));
  // Disable line scan mode
  nMode = 0;
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_LINESCAN_MODE, (void*)&nMode,
                          sizeof(nMode));
  // Return line scan mode
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_LINESCAN_MODE, (void*)&nMode,
                          sizeof(nMode));
}
if (nSupportedFeatures & IS_DEVICE_FEATURE_CAP_LINESCAN_NUMBER)
{
  // Set line number
    INT nLineNumber = 512;
    nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_LINESCAN_NUMBER,
                            (void*)&nLineNumber, sizeof(nLineNumber));
  nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_LINESCAN_NUMBER,
                          (void*)&nLineNumber, sizeof(nLineNumber));
}
}