dmFXUpdateImageBuffer(3dm) dmFXUpdateImageBuffer(3dm)
dmFXUpdateImageBuffer, dmFXUpdateImageBuffers, dmFXGetBufferFormat -
change the active size of a special effects buffer
#include <dmedia/fx_buffer.h>
DMstatus dmFXUpdateImageBuffer [Toc] [Back]
( const DMparams* imageFormat,
DMfxbuffer* buffer );
DMstatus dmFXUpdateImageBuffers [Toc] [Back]
( const DMparams* imageFormat,
int numberOfBuffers,
DMfxbuffer* buffers[] );
DMparams* dmFXGetBufferFormat
( DMfxbuffer buffer );
imageFormat A parameter list that describes the new image size to
be stored in the buffer.
buffer An image buffer.
numberOfBuffers The number of elements in the array buffers.
buffers An array of image buffers.
A special-effects image buffer has a fixed size, which is the amount of
storage allocated to store an image. By default, the buffers deals with
images of that size. They can also be used to deal with images that are
smaller. To do this, the "active size" of the buffer must be changed
with dmFXUpdateImageBuffer or dmFXUpdateImageBuffers.
dmFXUpdateImageBuffer is used to update the size of a single buffer, and
dmFXUpdateImageBuffers is used to update the size of several buffers at
once. The new size is taken from the DM_IMAGE_WIDTH and DM_IMAGE_HEIGHT
parameters in imageFormat.
The current size of a buffer, as well as its other image format
parameters, can be obtained by calling dmFXGetBufferFormat.
dmFXUpdateImageBuffer and dmFXUpdateImageBuffers will return DM_SUCCESS
if the size of all of the buffers was changed, or DM_FAILURE if not.
Page 1
dmFXUpdateImageBuffer(3dm) dmFXUpdateImageBuffer(3dm)
The parameter list returned by dmFXGetBufferFormat is owned by the
buffer. It may be queried, but should not be modified or freed.
dmFXAllocateImageBuffers(3dm)
PPPPaaaaggggeeee 2222 [ Back ]
|