 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_ColorTemperature (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)
Beschreibung
Mit is_ColorTemperature() kann bei Farbkameras die Farbtemperatur des Bildes auf einen festen Wert (in Kelvin) gesetzt werden. Die Funktion verwendet dazu soweit möglich die Hardware-Verstärkungsregler des Sensors. Zusätzlich kann zwischen verschiedenen Farbräumen gewählt werden. Eine bestimmte Farbtemperatur ergibt je nach Farbraum leicht unterschiedliche RGB-Werte.
Zusätzlich kann über die Funktion für die UI-1007XS die Farbtemperatur der Optikkorrektur abgefragt oder eingestellt werden.
|
Beachten Sie, dass beim ersten Funktionsaufruf von is_ColorTemperature() die aktuellen LUT-Werte berechnet werden. Dadurch kann – abhängig vom verwendeten System – der erste Funktionsaufruf etwas länger dauern. |
Ü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 nSizeOfParam angegeben.
Die Farbtemperatur bezeichnet die Temperatur, auf die ein schwarzer Körper erhitzt werden muss, damit er mit der entsprechenden Lichtfarbe leuchtet. Warmes Licht (rötlich) besitzt eine niedrigere Farbtemperatur als kaltes Licht (bläulich). Die folgende Tabelle zeigt einige Beispielwerte:
Lichtquelle |
Farbtemperatur |
Glühbirne (100 W) |
2800 |
Halogenlampe |
3200 |
Leuchtstoffröhre (kaltweiß) |
4000 |
Morgen- und Abendsonne |
5000 |
Mittagssonne |
5500-5800 |
Blitzlichtaufnahme |
6000 |
Bedeckter Himmel |
6500-7500 |
Nebel |
8000 |
|
Die Funktion is_ColorTemperature() kann nicht gleichzeitig mit dem automatischen Weißabgleich über is_SetAutoParameter()/is_AutoParameter() verwendet werden. |
Übergabeparameter
hCam |
Handle auf Kamera |
|---|---|
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
nSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
RGB_COLOR_MODEL_SRGB_D50 |
sRGB (Standard-RGB)-Farbraum mit einem Weißpunkt von 5000 Kelvin (Warmes Licht) |
RGB_COLOR_MODEL_SRGB_D65 |
sRGB (Standard-RGB)-Farbraum mit einem Weißpunkt von 6500 Kelvin (mittleres Tageslicht) |
RGB_COLOR_MODEL_CIE_RGB_E |
CIE-RGB-Farbraum mit Normbeleuchtung E |
RGB_COLOR_MODEL_ECI_RGB_D50 |
ECI-RGB-Farbraum mit einem Weißpunkt von 5000 Kelvin (Warmlicht) |
RGB_COLOR_MODEL_ADOBE_RGB_D65 |
Adobe-RGB-Farbraum mit einem Weißpunkt von 6500 Kelvin (mittleres Tageslicht). Der Adobe-RGB-Farbraum ist größer als der sRGB-Farbraum, kann aber von manchen Geräten nicht wiedergegeben werden. |
Rückgabewerte
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_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
// set new lens correction
IS_U32 u32LscModel = LSC_MODEL_D50;
is_ColorTemperature(hCam, COLOR_TEMPERATURE_CMD_SET_LENS_SHADING_MODEL, (void*)&u32LscModel, sizeof(u32LscModel));
// get current lens correction
IS_U32 u32LscModel = 0;
is_ColorTemperature(hCam, COLOR_TEMPERATURE_CMD_GET_LENS_SHADING_MODEL, (void*)&u32LscModel, sizeof(u32LscModel));
if (u32LscModel == LSC_MODEL_TL84){
...
}
// get supported lens correction
IS_U32 u32LscModel = 0;
is_ColorTemperature(hCam, COLOR_TEMPERATURE_CMD_GET_LENS_SHADING_MODEL_SUPPORTED, (void*)&u32LscModel, sizeof(u32LscModel));
if ((u32LscModel & LSC_MODEL_TL84) == LSC_MODEL_TL84){
// LSC_MODEL_TL84 supported....
...
}
