dmColorSetConvParams(3dm)			     dmColorSetConvParams(3dm)

NAME    [Toc]    [Back]

     dmColorSetConvParams, dmColorGetConvParams	- set/get the conversion
     parameters.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_color.h>

     DMstatus dmColorSetConvParams (const DMcolorconverter converter,
					  DMparams	  *convParams);
     DMstatus dmColorGetConvParams (const DMcolorconverter converter,
					  DMparams	  *convParams);

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     DM_COLOR_ERROR_NONE		 if operation is successful.
     DM_COLOR_ERROR_INVALID_CONVERTER	 if the	converter is invalid.

DESCRIPTION    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     dmColor(3dm) dmColorS
     glLoadMatrix(3G)


									PPPPaaaaggggeeee 2222