dmicdst(3dm)

NAME
     dmICSetDstParams, dmICGetDstParams, dmICGetDefaultDstParams - manipulate
     image converter context dst image format

SYNOPSIS
     #include <dmedia/dm_imageconvert.h>
     #include <dmedia/dm_image.h>

     DMstatus dmICSetDstParams(DMimageconverter converter, DMparams* dstParams);

     DMstatus dmICGetDstParams(DMimageconverter converter, DMparams* dstParams);

     DMstatus dmICGetDefaultDstParams(DMimageconverter converter, DMparams* dstParams);

DESCRIPTION
     The destination parameters describe the output image of the image
     converter.  The minimum set of parameters that must be present in the
     dstParams are:

     DM_IMAGE_WIDTH
                  an integer that describes the width of the image in pixels

     DM_IMAGE_HEIGHT
                  an integer that describes the height of the image in pixels

     DM_IMAGE_PACKING
                  an enum that describes the packing type of the image data

     DM_IMAGE_ORIENTATION
                  an enum describes the orientation of the image

     Valid values for each of these parameters are described in
     dmedia/dm_image.h.

     dmICSetDstParams sets the parameters that describe the output image
     format of the DMbuffer passed to the image converter in the next dmICSend
     call.

     DM_FAILURE is returned if the any of the required parameters is not
     present or if any of the parameter value is invalid.   When this happens,
     the input format of the converter is set to be the input format described
     by the last successful dmICSetSrcParams call.

     dmICGetDstParams gets the parameters that describe the output image
     format of the DMbuffer returned in the previous dmICReceive call.  Prior
     to any successful dmICReceive, the parameters returned are not defined.

     dmICGetDefaultDstParams returns the set of parameters and their default
     values that the converter understands and will examine in the
     dmICSetDstParams call.
SEE ALSO
     dmSetImageDefaults(3dm), mvGetTrackDataParams(3dm), dmICCreate(3dm),
     dmICSend(3dm), dmICReceive(3dm), dmSetImageDefaults(3dm),
     dmICSetSrcParams(3dm), dmICSetConvParams(3dm), dmGetError(3dm),
     dmICWork(3dm).