 |
 |
|---|---|
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:
•Bei den Modellen UI-336x/UI-536x und UI-337x/UI-537x: FPN-Korrektur aktivieren/deaktivieren. Die FPN-Korrektur ist standardmäßig aktiviert.
•Bei den Modellen UI-313x, UI-314x, UI-316x, UI-318x: FPN-Korrektur aktivieren/deaktivieren und den Status der FPN-Kalibrierung abfragen.
Ü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_FPN_CORRECTION |
Fixed-Pattern-Noise-Korrektur wird unterstützt. |
UINT nMode = 0;
/* Get default FPN correction mode */
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_FPN_CORRECTION_MODE_DEFAULT,
(void*)&nMode, sizeof(nMode));
/* Get current FPN correction mode */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_FPN_CORRECTION_MODE,
(void*)&nMode, sizeof(nMode));
/* Set FPN correction mode to hardware */
nMode = IS_FPN_CORRECTION_MODE_HARDWARE;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_FPN_CORRECTION_MODE,
(void*)&nMode, sizeof(nMode));
// Get if loading the FPN correction data is enabled
UINT nFPNCorrectionDataLoading = IS_FPN_CORRECTION_DATA_LOADING_OFF;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_GET_FPN_CORRECTION_DATA_LOADING, (void*)&nFPNCorrectionDataLoading , sizeof(nFPNCorrectionDataLoading ));
if(nFPNCorrectionDataLoading == IS_FPN_CORRECTION_DATA_LOADING_ON)
{
// FPN correction data are loaded
}
else // (nFPNCorrectionDataLoading == IS_FPN_CORRECTION_DATA_LOADING_OFF)
{
// FPN correction data are not loaded
}
// Get the default value for loading the FPN correction data
UINT nFPNCorrectionDataLoadingDefault = IS_FPN_CORRECTION_DATA_LOADING_OFF;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_GET_FPN_CORRECTION_DATA_LOADING_DEFAULT, (void*)&nFPNCorrectionDataLoadingDefault , sizeof(nFPNCorrectionDataLoadingDefault ));
// Disable loading the FPN correction data
UINT nFPNCorrectionDataLoading = IS_FPN_CORRECTION_DATA_LOADING_OFF;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_SET_FPN_CORRECTION_DATA_LOADING, (void*)&nFPNCorrectionDataLoading , sizeof(nFPNCorrectionDataLoading ));
// Enable loading the FPN correction data
nFPNCorrectionDataLoading = IS_FPN_CORRECTION_DATA_LOADING_ON;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_SET_FPN_CORRECTION_DATA_LOADING, (void*)&nFPNCorrectionDataLoading , sizeof(nFPNCorrectionDataLoading ));
