dmFXMovieRenderImage(3dm) dmFXMovieRenderImage(3dm)
dmFXMovieRenderImage, dmFXMovieInsertImage, dmFXMovieRenderFields,
dmFXMovieInsertFields - transfer images between movies and special
effects
#include <dmedia/fx_buffer.h>
DMstatus dmFXMovieRenderImage [Toc] [Back]
( MVid movie,
MVtime time,
MVtimescale timeScale,
int inputUsage,
DMfxbuffer* destinationBuffer )
DMstatus dmFXMovieInsertImage [Toc] [Back]
( MVid track,
MVtime time,
MVtime duration,
MVtimescale timeScale,
DMfxbuffer* sourceBuffer )
DMstatus dmFXMovieRenderFields [Toc] [Back]
( MVid movie,
MVtime time,
MVtime duration,
MVtimescale timeScale,
DMfxbuffer* dstFieldA,
DMfxbuffer* dstFieldB )
DMstatus dmFXMovieInsertFields [Toc] [Back]
( MVid track,
MVtime time,
MVtime duration,
MVtimescale timeScale,
DMfxbuffer* srcFieldA,
DMfxbuffer* srcFieldB )
movie The movie that contains the image to be rendered.
track The track into which a new image is inserted.
time A time within the movie.
duration Specifies how long an inserted image will be
displayed when the movie is played.
Page 1
dmFXMovieRenderImage(3dm) dmFXMovieRenderImage(3dm)
timeScale Specifies the units for time and duration.
inputUsage Specifies how the image buffer will be used, a
combination of bufInputDirect, bufInputTexture,
bufInputDrawPixels, and bufInputMovie.
destinationBuffer The buffer in which the resulting image is placed.
sourceBuffer A buffer containing the image to be inserted into the
movie.
dstFieldA Field buffer where the even numbered scanlines
(counting from 0) of the resulting image are placed.
dstFieldB Field buffer where the odd numbered scanlines
(counting from 0) of the resulting image are placed.
srcFieldA Field buffer which contains the even numbered
scanlines (counting from 0) of the image to be
inserted into the movie.
srcFieldB Field buffer which contains the odd numbered
scanlines (counting from 0) of the image to be
inserted into the movie.
dmFXmovieRenderImage renders a movie at the given time (see
mvRenderMovieToImageBuffer(3dm)), and places the result in
destinationBuffer. It is equivalent to calling
dmFXSetupOutputImageBuffer, mvRenderMovieToImageBuffer, and
dmFXCleanupOutputImageBuffer in sequence, but may be more efficient.
dmFXmovieRenderImage takes into account the current movie rectangle (see
mvSetMovieRect(3dm)) to decide the location of the image in the buffer.
dmFXMovieInsertImage take a buffer containing an image, and inserts that
image in the given track at the given time. It is equivalent to calling
dmFXSetupInputImageBuffer, mvInsertFramesAtTime, and
dmFXCleanupInputImageBuffer in sequence, but may be more efficient.
dmFXMovieRenderFields renders a movie at the given time (see
mvRenderMovieToImageBuffer(3dm)), and places the result in dstFieldA and
dstFieldB. dstFieldA contains the even numbered scanlines (counting from
0), and dstFieldB contains the odd numbered scanlines. It is equivalent
in functionality to calling dmFXMovieRenderImage(3dm) followed by
dmFXSplitFields(3dm), but might be more efficient under some conditions.
dmFXMovieInsertFields takes two buffers containing interlaced image data,
and inserts those fields into the given track at the given time.
dstFieldA contains the even numbered scanlines of the full image
(counting from 0) and dstFieldB contains the odd numbered scanlines. It
is equivalent in functionality to calling dmFXJoinFields(3dm) followed by
Page 2
dmFXMovieRenderImage(3dm) dmFXMovieRenderImage(3dm)
dmFXMovieInsertImage(3dm), but might be more efficient under some
conditions.
All functions return DM_SUCCESS if the operation was completed
successfully, and DM_FAILURE if not. In the case of failure, error
information can be obtained from dmGetError(3dm).
dmFXAllocateImageBuffers(3dm), dmFXSetupInputImageBuffer(3dm),
dmFXSetupScanlineBuffer(3dm), dmFXSplitFields(3dm), dmFXJoinFields(3dm),
dmGetError(3dm), mvSetMovieRect(3dm).
PPPPaaaaggggeeee 3333 [ Back ]
|
