dmIC(3dm)							     dmIC(3dm)

NAME    [Toc]    [Back]

     dmICSetConvParams,	dmICGetConvParams, dmICGetDefaultConvParams -
     manipulate	conversion controls of an image	converter context

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_imageconvert.h>

     DMstatus dmICSetConvParams(DMimageconverter converter, DMparams* convParams);

     DMstatus dmICGetConvParams(DMimageconverter converter, DMparams* convParams);

     DMstatus dmICGetDefaultConvParams(DMimageconverter	converter, DMparams* convParams);

DESCRIPTION    [Toc]    [Back]

     The conversion parameters convParams control the image converter's
     operation.

     The list of supported conversion parameters vary from converter to
     converter.	 dmICGetDefaultConvParams returns the set of supported
     parameters	and their default values.  Conversion parameters supported by
     some converters are:

     DM_IMAGE_QUALITY_SPATIAL    [Toc]    [Back]
		  describes the	spatial	quality	of a conversion	algorithm.
		  This is a float value	that varies from 0 to 1.0

     DM_IMAGE_QUALITY_TEMPORAL    [Toc]    [Back]
		  describes the	temporal quality of a conversion algorithm.
		  This is a float value	that varies from 0 to 1.0

     DM_IMAGE_BITRATE    [Toc]    [Back]
		  describes the	bitrate	of a compressed	video stream.  This is
		  an int value in bits per second.

     dmICSetConvParams sets the	parameters that	describe the image format in
     the DMbuffer to be	presented the image converter in the next dmICSend
     call.

     DM_FAILURE	is returned if any of the parameter in the list	is invalid.
     When this happens,	the conversion params are not modified and remain as
     they were set with	the last successfuldmICSetConvParams call.

     dmICGetConvParams returns the parameters that describe the	image format
     in	the DMbuffer returned in the previous dmICReceive call.	 Prior to any
     successful	dmICReceive, the parameters returned are not defined.

     dmICGetDefaultConvParams returns the complete set of parameters
     recognized	by the converter and their default values.







									Page 1






dmIC(3dm)							     dmIC(3dm)

SEE ALSO    [Toc]    [Back]

     dmICCreate(3dm), dmICSetSrcParams(3dm), dmICSetDstParams(3dm),
     dmGetError(3dm).


									PPPPaaaaggggeeee 2222