is_DeviceFeature

USB 3.1 Gen 1

USB 3.0

USB 2.0

GigE

USB 3.1 Gen 1

USB 3.0

USB 2.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:

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

•Rauschunterdrückung aktivieren

•FPN-Korrektur setzen

•Hohen Dynamikumfang aktivieren

•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_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));
}
}

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.