AW00089317000 Color Creation and Enhancement
Basler ace GigE 189
Color Adjustment Parameters
The initial parameter that you must consider when working with the color adjustment feature is the
Processed Raw Enable parameter. If you are working with a camera that is set to output pixel data
in a Bayer xx format, then the Processed Raw Enabled parameter must be set to "enabled", if you
want to use color enhancement. The camera will then be able to perform color enhancements on
the raw RGB data from the sensor and still be able to output the pixel data in one of the Bayer
formats. If the camera is set for a Bayer xx pixel data output format and the Processed Raw Enable
parameter is not set to enabled, the matrix color transformation feature and the color adjustment
feature will have no effect on the camera operation.
You can enable or disable the color adjustment feature by setting the value of the Color Adjustment
Enable parameter to true or false.
You can use the Color Adjustment Selector parameter to select a color to adjust. The colors you
can select are: red, yellow, green, cyan, blue, and magenta.
You can use the Color Adjustment Hue parameter to set the hue for the selected color as a floating
point value in a range from -4.0 to +3.96875.
As an alternative, you can use the Color Adjustment Hue Raw parameter to set the hue as an
integer value on a scale ranging from -128 to +127. This integer range maps linearly to the floating
point range with -256 being equivalent to -4.0, 32 being equivalent to 1.0, and +255 being
equivalent to +3.96875.
.
You can use the Color Adjustment Saturation parameter to set the saturation for the selected color
as a floating point value in a range from 0.0 to +1.99219.
As an alternative, you can use the Color Adjustment Saturation Raw parameter to set the saturation
as an integer value on a scale ranging from 0 to 255. This integer range maps linearly to the floating
point range with 0 being equivalent to 0.0, 128 being equivalent to 1.0, and +255 being equivalent
to +1.99219.
Enabling and Setting Color Adjustment
You can set the Processed Raw Enable, Color Adjustment Enable, Color Adjustment Selector,
Color Adjustment Hue, Color Adjustment Hue Raw, Color Adjustment Saturation, and Color
Adjustment Saturation Raw parameter values from within your application software by using the
Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG8
output, and therefore you must set the Processed Raw Enable parameter value to enabled.
The following code snippet illustrates using the API to set the parameter values:
// Set the camera for Bayer BG8 pixel data output format
Camera.PixelFormat.SetValue( PixelFormat_BayerBG8 );
// Because the camera is set for a Bayer output format, the Processed Raw
// Enabled parameter must be set to enabled
Camera.ProcessedRawEnable.SetValue( true );
// Enable the Color Adjustment feature