dmIC(3dm)							     dmIC(3dm)

NAME    [Toc]    [Back]

     dmICCreate, dmICDestroy - create and destroy image	converter context

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_imageconvert.h>

     DMstatus dmICCreate(int i,	DMimageconverter *converter);

     void dmICDestroy(DMimageconverter converter);

DESCRIPTION    [Toc]    [Back]

     dmICCreate	creates	an image converter context.  The actual	selection of
     an	image converter	is separate from this operation.  The i	argument
     specifies the image converter to create and is a value in the range of 0
     to	one less than the return value of dmICGetNum. The return value of
     dmICChooseConverter is always valid directly in dmICCreate.

     NOTE: The i value for a given image converter may change at any time.

     The converter argument is the address of a	caller supplied	data structure
     for for use as a handle in	subsequent operations on this image converter
     context.

     A process may have	multiple image converters open simultaneously as well
     as	multiple contexts of the same image converter.	However, a given image
     converter may itself limit	the number of simultaneous open	contexts on
     both a per	process	and per	system basis.

     dmICDestroy frees the image converter context.  No	further	operations are
     valid on this handle.  The	caller is responsible for deallocating the
     storage for converter.

SEE ALSO    [Toc]    [Back]

     dmICGetNum(3dm), dmICGetDescription(3dm), dmICChooseConverter(3dm),
     dmICSetSrcParams(3dm), dmICSetDstParams(3dm), dmICSetConvParams(3dm),
     dmICSetDstPool(3dm), dmICGetDstQueueFD(3dm), dmICSend(3dm),
     dmICReceive(3dm), dmICWork(3dm).


									PPPPaaaaggggeeee 1111