USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 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:

Die Funktion is_ColorTemperature() kann nicht gleichzeitig mit dem automatischen Weißabgleich über is_SetAutoParameter()/is_AutoParameter() verwendet werden.

Übergabeparameter

hCam	Handle auf Kamera
nCommand Farbraum einstellen COLOR_TEMPERATURE_CMD_GET_SUPPORTED_RGB_COLOR_MODELS Gibt die unterstützten Farbräume zurück. Mehr Informationen pParam: Zeiger auf Bitmaske vom Typ UINT In der Bitmaske werden die unterstützten Modi logisch verodert zurückgegeben (siehe Tabelle Farbräume). nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_SET_RGB_COLOR_MODEL Setzt einen Farbraum. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der zu setzende Wert übergeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_RGB_COLOR_MODEL Gibt den eingestellten Farbraum zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der aktuelle Wert zurückgegeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_RGB_COLOR_MODEL_DEFAULT Gibt den Standard-Farbraum zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der Standardwert zurückgegeben wird. nSizeOfParam: 4 Farbtemperatur einstellen COLOR_TEMPERATURE_CMD_SET_TEMPERATURE Setzt eine Farbtemperatur. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der zu setzende Wert übergeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_TEMPERATURE Gibt die eingestellte Farbtemperatur zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der aktuelle Wert zurückgegeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_TEMPERATURE_MIN Gibt den minimalen Wert für die Farbtemperatur zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der minimale Wert zurückgegeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_TEMPERATURE_MAX Gibt den maximalen Wert für die Farbtemperatur zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der maximale Wert zurückgegeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_TEMPERATURE_INC Gibt das Inkrement für die Einstellung der Farbtemperatur zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der das Inkrement zurückgegeben wird. nSizeOfParam: 4 COLOR_TEMPERATURE_CMD_GET_TEMPERATURE_DEFAULT Gibt den Standardwert für die Farbtemperatur zurück. Mehr Informationen pParam: Zeiger auf Variable vom Typ UINT, in der der Standardwert zurückgegeben wird. nSizeOfParam: 4 Farbtemperatur für die Optikkorrektur (nur UI-1007XS) COLOR_TEMPERATURE_CMD_GET_LENS_SHADING_MODEL Gibt die eingestellte Farbtemperatur für die Optikkorrektur zurück. Beispiel COLOR_TEMPERATURE_CMD_GET_LENS_SHADING_MODEL_DEFAULT Gibt den Standardwert für die Farbtemperatur der Optikkorrektur zurück. COLOR_TEMPERATURE_CMD_GET_LENS_SHADING_MODEL_SUPPORTED Gibt die unterstützten Farbtemperaturen für die Optikkorrektur zurück: •LSC_MODEL_AGL (0x0001): Farbraum mit einem Weißpunkt von 3000 Kelvin. •LSC_MODEL_TL84 (0x0002): Farbraum mit einem Weißpunkt von 4000 Kelvin. •LSC_MODEL_D50 (0x0004): Farbraum mit einem Weißpunkt von 5000 Kelvin. •LSC_MODEL_D65 (0x0008): Farbraum mit einem Weißpunkt von 6500 Kelvin. COLOR_TEMPERATURE_CMD_SET_LENS_SHADING_MODEL Setzt eine neue Farbtemperatur für die Optikkorrektur. Beispiel
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
nSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Farbräume

Rückgabewerte

Verwandte Funktionen

•is_SetHardwareGain()

•is_AutoParameter()

•is_SetAutoParameter()

Beispiel

// 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....
...
}