dmIC(3dm)dmIC(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.
Page 1
dmIC(3dm)dmIC(3dm)SEE ALSOdmICCreate(3dm), dmICSetSrcParams(3dm), dmICSetDstParams(3dm),
dmGetError(3dm).
Page 2
