![]() |
![]() |
|---|---|
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
Multi-Integration-Modus verwenden
Kamera-LUT mit RAW-Format verwenden
Pegelgesteuerten Trigger verwenden
Erweiterten Pixeltakt verwenden
Internen Bildspeicher verwenden
Ü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. |
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 |
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));
}
}