dmIC(3dm)                                                            dmIC(3dm)



NAME
     dmICGetSrcPoolParams, dmICGetDstPoolParams, dmICSetDstPool - get the
     input/output buffering needs of the image converter

SYNOPSIS
     #include <dmedia/dmimageconvert.h>

     DMstatus dmICGetSrcPoolParams(DMimageconverter converter, DMparams* poolParams);

     DMstatus dmICGetDstPoolParams(DMimageconverter converter, DMparams* poolParams);

     DMstatus dmICSetDstPool(DMimageconverter ic, DMbufferpool pool);

DESCRIPTION
     The image converters only operate on DMbuffer's allocated from a
     DMbufferpool (see dmBuffer(3dm)).  Prior to setting up a pool for use by
     an image converter, users must call dmICGetSrcPoolParams and
     dmICGetDstPoolParams to set up the poolParams used to initialize a pool.
     If any of the source or destination buffers are to be shared with other
     subsystems, the Video Library (VL) or the Graphics Library (OpenGL), the
     application must make the corresponding calls in those libraries to make
     sure that their pool requirements are also satisfied (See
     vlDMPoolGetParams(3dm), dmBufferGetGLPoolParams(3dm))

     Source buffers are allocated by the application, and destination buffers
     are allocated by the system.  The application is responsible for creating
     both the source pool and the destination pool.  The application must also
     register the destination pool it created with the image converter using
     dmICSetDstPool prior to any send or receive operation on the image
     converter.

     dmICGetSrcPoolParams adds the imageconverter's input buffering
     requirements by setting parameters in poolParams This must be called
     before passing the poolParams to dmBufferCreatePool.

     dmICGetDstPoolParams similarily adds the imageconverter's output buffer
     requirements to poolParams This must be called before passing the
     poolParams to dmBufferCreatePool.

     dmICSetDstPool sets the DMbufferpool from which the converter allocates
     each output DMbuffer.

SEE ALSO
     dmICCreate(3dm), dmBufferCreatePool(3dm).











                                                                        Page 1