dmColorSetConvParams(3dm)dmColorSetConvParams(3dm)NAME
dmColorSetConvParams, dmColorGetConvParams - set/get the conversion
parameters.
SYNOPSIS
#include <dmedia/dm_color.h>
DMstatus dmColorSetConvParams (const DMcolorconverter converter,
DMparams *convParams);
DMstatus dmColorGetConvParams (const DMcolorconverter converter,
DMparams *convParams);
PARAMETERS
DMcolorconverter converter
The converter upon which the action is to be applied.
DMparams *convParams
The DMparams which provides/accepts the image conversion parameters.
RETURNED VALUE
DM_COLOR_ERROR_NONE if operation is successful.
DM_COLOR_ERROR_INVALID_CONVERTER if the converter is invalid.
DESCRIPTION
All image conversion parameters are set/get via DMparams using these
calls. See dmColor man page for more details and example code.
The following tokens are supported as conversion parameters:
DM_COLOR_CONV_CONTRAST
DM_COLOR_CONV_BRIGHTNESS
DM_COLOR_CONV_SATURATION
DM_COLOR_CONV_HUE
DM_COLOR_CONV_RED_BIAS
DM_COLOR_CONV_RED_SCALE
DM_COLOR_CONV_GREEN_BIAS
DM_COLOR_CONV_GREEN_SCALE
DM_COLOR_CONV_BLUE_BIAS
DM_COLOR_CONV_BLUE_SCALE
DM_COLOR_CONV_DEFAULT_ALPHA
DM_COLOR_CONV_TRANSFORM_MATRIX
DM_COLOR_CONV_SUBSAMPLING_FILTER
Contrast, brightness, saturation, and hue are described in dmColor. The
red, green, and blue bias and scale gives the user a little flexibility
on the internal workings. Internally, these colors are mapped onto
[0..1]. So, for example, to invert the red in the image, set bias to 1
and scale to -1. This results in the mapped range now being [1..0]. The
src and dst bias and scale values are entirely independent of these
values. A default alpha sets the default to be used when alpha is
unknown, such as when converting from CbYCrY to RGBA. The Color Space
Library allows the user to set up a conversion matrix which includes the
color space transform, contrast, brightness, saturation, hue, RGB
Page 1
dmColorSetConvParams(3dm)dmColorSetConvParams(3dm)
bias/scale values (as above), and colorimetry parameters. This matrix is
a DMfloatarray [16] which is compatible with glLoadMatrix. Below are the
only three possible values for DM_COLOR_CONV_SUBSAMPLING_FILTER. For
their description, see dmColor.
DM_COLOR_SUBSAMPLINGFILTER_TYPE0
DM_COLOR_SUBSAMPLINGFILTER_TYPE1
DM_COLOR_SUBSAMPLINGFILTER_TYPE2
SEE ALSOdmColor(3dm)dmColorSetSrcParams(3dm)dmColorGetSrcParams(3dm)glLoadMatrix(3G)
Page 2
