*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> fx/dmFXUpdateImageBuffer (3d)              


dmFXUpdateImageBuffer(3dm)			    dmFXUpdateImageBuffer(3dm)

NAME    [Toc]    [Back]

     dmFXUpdateImageBuffer, dmFXUpdateImageBuffers, dmFXGetBufferFormat	-
     change the	active size of a special effects buffer

SYNOPSIS    [Toc]    [Back]

     #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 );

PARAMETERS    [Toc]    [Back]

     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.

DESCRIPTION    [Toc]    [Back]

     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.

RETURN VALUES    [Toc]    [Back]

     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.

SEE ALSO    [Toc]    [Back]


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
fxSetupScanlineBuffer IRIX get information about a special-effects image buffer
dmPMCreateEffect IRIX create and destroy special effects
dmPMProcessClip IRIX apply special effects to movies
dmPMGetPlugin IRIX retrieve a pointer to a special effects plugin
fxSetupInputImageBuffer IRIX manage special-effects image buffers
dmFXDrawPixels IRIX pixel transfer operations for special effects
fxMovieRenderImage IRIX transfer images between movies and special effects
dmFXTexImage2D IRIX load an image for use as a texture for special effects
fxAllocateImageBuffers IRIX create and destroy image buffers for special effects
lmcolor IRIX change the effect of color commands while lighting is active
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service