dmFXMovieRenderImage(3dm)                            dmFXMovieRenderImage(3dm)



NAME
     dmFXMovieRenderImage, dmFXMovieInsertImage, dmFXMovieRenderFields,
     dmFXMovieInsertFields - transfer images between movies and special
     effects


SYNOPSIS
     #include <dmedia/fxbuffer.h>

     DMstatus dmFXMovieRenderImage
           ( MVid movie,
             MVtime time,
             MVtimescale timeScale,
             int inputUsage,
             DMfxbuffer* destinationBuffer )

     DMstatus dmFXMovieInsertImage
           ( MVid track,
             MVtime time,
             MVtime duration,
             MVtimescale timeScale,
             DMfxbuffer* sourceBuffer )

     DMstatus dmFXMovieRenderFields
           ( MVid movie,
             MVtime time,
             MVtime duration,
             MVtimescale timeScale,
             DMfxbuffer* dstFieldA,
             DMfxbuffer* dstFieldB )

     DMstatus dmFXMovieInsertFields
           ( MVid track,
             MVtime time,
             MVtime duration,
             MVtimescale timeScale,
             DMfxbuffer* srcFieldA,
             DMfxbuffer* srcFieldB )


PARAMETERS
     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.


DESCRIPTION
     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.


RETURN VALUES
     All functions return DMSUCCESS if the operation was completed
     successfully, and DMFAILURE if not.  In the case of failure, error
     information can be obtained from dmGetError(3dm).


SEE ALSO
     dmFXAllocateImageBuffers(3dm), dmFXSetupInputImageBuffer(3dm),
     dmFXSetupScanlineBuffer(3dm), dmFXSplitFields(3dm), dmFXJoinFields(3dm),
     dmGetError(3dm), mvSetMovieRect(3dm).









































                                                                        Page 3