mvInsertFramesAtTime(3dm)mvInsertFramesAtTime(3dm)NAME
mvInsertFramesAtTime: - edit/manipulate a movie track
SYNOPSIS
#include <dmedia/moviefile.h>
DMstatus mvInsertFramesAtTime( MVid track,
MVtime time, MVtime duration,
MVtimescale timeScale,
void *buffer, size_t bufferSize,
DMparams *bufferParams,
int storedParamsIndex );
DESCRIPTIONmvInsertFramesAtTime 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 ALSOmvIntro(3dm), mvDeleteFramesAtTime(3dm), mvGetErrno(3dm).
Page 2
