 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_Gamma(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
is_Gamma() aktiviert die digitale Gammakorrektur, bei der eine Gamma-Kennlinie auf das Bild angewendet wird. Wenn bei USB 3 uEye CP/LE/ML Kameras die Hardware-Farbberechnung verwendet wird, erfolgt die Gammakorrektur in der Kamera. Wenn die Farbberechnung im PC durchgeführt wird (Software-Konvertierung), erfolgt die Gammakorrektur in der Software.
|
Wenn als Farbformat Raw Bayer (Rohdaten) eingestellt ist, wird die Gammakorrektur nicht angewendet. |
|
Typische Werte für Gamma liegen zwischen 1,6 und 2,2. |
Ü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. |
Rückgabewert
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_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
/* set gamma value to 1.6 */
INT nGamma = 160;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_SET, (void*) &nGamma, sizeof(nGamma));
/* set gamma to default value */
INT nGamma;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_GET_DEFAULT, (void*)&nGamma, sizeof(nGamma));
if (nRet == IS_SUCCESS)
{
is_Gamma(hCam, IS_GAMMA_CMD_SET, (void*)&nGamma, sizeof(nGamma));
}
/* read gamma value to nGamma */
INT nGamma;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_GET, (void*) &nGamma, sizeof(nGamma));
Siehe auch: •Grundlagen: Kennlinien und LUT •Grundlagen: Farbberechnung •Programmierung: is_SetColorConverter() |
