mvInsertFramesAtTime(3dm)			     mvInsertFramesAtTime(3dm)

NAME    [Toc]    [Back]

     mvInsertFramesAtTime:  - edit/manipulate a	movie track

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>


     DMstatus mvInsertFramesAtTime( MVid track,
			      MVtime time, MVtime duration,
			      MVtimescale timeScale,
			      void *buffer, size_t bufferSize,
			      DMparams *bufferParams,
			      int storedParamsIndex );

DESCRIPTION    [Toc]    [Back]

     mvInsertFramesAtTime inserts a series of data chunks into the track.

     time is the time at which the new segment is to be	inserted.  If the time
     specified is beyond the duration of the track, an empty segment will
     first be inserted to cover	the time between the duration of the track and
     the time specified	by the user.

     duration is the duration for which	the inserted segment is	to last.

     timescale is the timescale	for time and duration.

     buffer is a pointer to a buffer of	uncompressed data to be	inserted.

     bufferSize	is the size in bytes of	buffer.	 This parameter	is used	by the
     movie library to determine	the number of frames it	contains.

     bufferParams is the set of	DMparams that describes	the data pointed to by
     buffer.  This function will return	DM_FAILURE if the necessary parameters
     required to describe the uncompressed data	are not	present.  The
     parameters	required are the same as those required	by mvAddTrack(3dm),
     and are specific to the medium of the track.

     storedParamsIndex is the index of the params that describe	how the	data
     should be stored in the file.  (This index	can be obtained	by the
     function mvAddTrackDataParams(3dm).  The data params at index zero	are
     the track params, which can be obtained by	calling	mvGetParams(3dm) on a
     track). The movie library will compare the	buffer params to the stored
     params and	do the necessary conversions before the	data is	added to the
     file.  This function will return DM_FAILURE if this parameter is out of
     range.

     (For definitions on time, duration	and timescale of a track, see the
     `Time and Timescale'' section of mvIntro(3dm)(3dm).




									Page 1






mvInsertFramesAtTime(3dm)			     mvInsertFramesAtTime(3dm)



     When these	functions return DM_FAILURE, more detailed information about
     the failure can be	obtained from mvGetErrno(3dm).

SEE ALSO    [Toc]    [Back]

     mvIntro(3dm), mvDeleteFramesAtTime(3dm), mvGetErrno(3dm).


									PPPPaaaaggggeeee 2222