dmIC(3dm)dmIC(3dm)NAME
dmICGetSrcPoolParams, dmICGetDstPoolParams, dmICSetDstPool - get the
input/output buffering needs of the image converter
SYNOPSIS
#include <dmedia/dm_imageconvert.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 ALSOdmICCreate(3dm), dmBufferCreatePool(3dm).
Page 1
