fxMovieRenderImage(3dm)
dmFXMovieRenderImage, dmFXMovieInsertImage, dmFXMovieRenderFields, dmFXMovieInsertFields - transfer images between movies and special effects
As shipped in IRIX 6.5.5. Unchanged since IRIX 6.5.
NAME dmFXMovieRenderImage, dmFXMovieInsertImage, dmFXMovieRenderFields, dmFXMovieInsertFields - transfer images between movies and special effects SYNOPSIS #include <dmedia/fx_buffer.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. 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 dmFXMovieInsertImage(3dm), but might be more efficient under some conditions. RETURN VALUES 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). SEE ALSO dmFXAllocateImageBuffers(3dm), dmFXSetupInputImageBuffer(3dm), dmFXSetupScanlineBuffer(3dm), dmFXSplitFields(3dm), dmFXJoinFields(3dm), dmGetError(3dm), mvSetMovieRect(3dm).