EasyManuals Logo

THORLABS DCU223x User Manual

THORLABS DCU223x
530 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Page #182 background imageLoading...
Page #182 background image
© 2013 Thorlabs GmbH180
DCx Cameras
4.3.10 is_ColorTemperature
USB 2.0
USB 3.0
USB 2.0
USB 3.0
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.
The color temperature is the temperature to which a black body radiator has to be heated to glow and give off light
in the corresponding color. Warm light (reddish) has a lower color temperature than cold light (bluish). The
following table lists a few example values:
Light source
Color temperature
Light bulb (100 W)
2800
Halogen lamp
3200
Fluorescent lamp (cold white)
4000
Morning and evening sunlight
5000
Noon sunlight
5500-5800
Flash strobe
6000
Overcast daylight
6500-7500
Fog
8000
Note
The is_ColorTemperature() function cannot be used simultaneously with the automatic white balance function
in is_SetAutoParameter() /is_AutoParameter() .
Input parameters
hCam
Camera handle
nCommand
Setting the color space
COLOR_TEMPERATURE_CMD_GET_SUPPORTED_RGB_C
OLOR_MODELS
Returns the supported color spaces .
More details
pParam: Pointer to a bit mask of type UINT
The bit mask returns the supported modes, linked by
logical ORs (see Color spaces table).
nSizeOfParam: 4
COLOR_TEMPERATURE_CMD_SET_RGB_COLOR_MODEL
Sets a color space .
More details
pParam: Pointer to variable of type UINT that passes
the value to be set.
nSizeOfParam: 4
COLOR_TEMPERATURE_CMD_GET_RGB_COLOR_MODEL
Returns the set color space .
303 167
182
182
182
182

Table of Contents

Questions and Answers:

Question and Answer IconNeed help?

Do you have a question about the THORLABS DCU223x and is the answer not in the manual?

THORLABS DCU223x Specifications

General IconGeneral
BrandTHORLABS
ModelDCU223x
CategorySecurity Camera
LanguageEnglish

Related product manuals