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


     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 ALSO
     dmColor(3dm) dmColorSetSrcParams(3dm) dmColorGetSrcParams(3dm)
     glLoadMatrix(3G)


                                                                        Page 2