|
|
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)
Description
Using is_ColorTemperature() you can fix a setting (in kelvins) for the color temperature of an image when you are using a color camera. The function will use the sensor's hardware gain controls for the setting, as far as possible. In addition, you can choose between different color spaces. A specific color temperature will result in slightly differing RGB values, depending on the selected color space.
The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a variable of the UINT type. The size of the memory area to which pParam refers is specified in the nSizeOfParam input parameter.
|
|
|
|
Input parameters
hCam |
Camera handle |
||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||
pParam |
Pointer to a function parameter, whose function depends on nCommand. |
||||||||||||||||||||||||||||||||||
nSizeOfParam |
Size (in bytes) of the memory area to which pParam refers. |
||||||||||||||||||||||||||||||||||
RGB_COLOR_MODEL_SRGB_D50 |
sRGB (standard RGB) color space with a white point of 5000 kelvins (warm light) |
RGB_COLOR_MODEL_SRGB_D65 |
sRGB (standard RGB) color space with a white point of 6500 kelvins (mid daylight) |
RGB_COLOR_MODEL_CIE_RGB_E |
CIE-RGB color space with standard illumination E |
RGB_COLOR_MODEL_ECI_RGB_D50 |
ECI-RGB color space with a white point of 5000 kelvins (warm light) |
RGB_COLOR_MODEL_ADOBE_RGB_D65 |
Adobe RGB color space with a white point of 6500 kelvins (mid daylight). The Adobe RGB color space is larger than the sRGB color space, but not all devices can render it. |
Return values
IS_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_SUCCESS |
Function executed successfully |
Related functions
Suggestion for improvement? Send us your short Feedback on this chapter.
Thank you very much!
For technical questions please contact you local distributor or use the support form on our website.