dmicconv(3dm)

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

SYNOPSIS
     #include <dmedia/dm_imageconvert.h>

     DMstatus dmICSetConvParams(DMimageconverter converter, DMparams* convParams);

     DMstatus dmICGetConvParams(DMimageconverter converter, DMparams* convParams);

     DMstatus dmICGetDefaultConvParams(DMimageconverter converter, DMparams* convParams);

DESCRIPTION
     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
                  describes the spatial quality of a conversion algorithm.
                  This is a float value that varies from 0 to 1.0

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

     DM_IMAGE_BITRATE
                  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.
SEE ALSO
     dmICCreate(3dm), dmICSetSrcParams(3dm), dmICSetDstParams(3dm),
     dmGetError(3dm).