dmIC(3dm)							     dmIC(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

     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    [Toc]    [Back]
		  an integer that describes the	width of the image in pixels

     DM_IMAGE_HEIGHT    [Toc]    [Back]
		  an integer that describes the	height of the image in pixels

     DM_IMAGE_PACKING    [Toc]    [Back]
		  an enum that describes the packing type of the image data

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





									Page 1






dmIC(3dm)							     dmIC(3dm)

SEE ALSO    [Toc]    [Back]

     dmSetImageDefaults(3dm), mvGetTrackDataParams(3dm), dmICCreate(3dm),
     dmICSend(3dm), dmICReceive(3dm), dmSetImageDefaults(3dm),
     dmICSetSrcParams(3dm), dmICSetConvParams(3dm), dmGetError(3dm),
     dmICWork(3dm).


									PPPPaaaaggggeeee 2222