mvDeleteFramesAtTime(3dm)mvDeleteFramesAtTime(3dm)NAME
mvInsertTrackGapAtTime mvDeleteFramesAtTime, mvCopyFramesAtTime-
edit/manipulate a movie track
SYNOPSIS
#include <dmedia/moviefile.h>
DMstatus mvDeleteFramesAtTime( MVid track, MVtime time,
MVtime duration, MVtimescale timeScale );
DMstatus mvInsertTrackGapAtTime( MVid track, MVtime time,
MVtime duration, MVtimescale timeScale );
DMstatus mvCopyFramesAtTime( MVid srcTrack, MVtime srcTime,
MVtime srcDuration, MVtimescale srcTimeScale,
MVid dstTrack, MVtime dstTime,
MVtimescale dstTimeScale,
DMboolean byReference );
DESCRIPTION
These functions edit tracks. They are medium-neutral and can be used for
all tracks.
mvDeleteFramesAtTime
This function deletes a segment of the track.
track is the track id of the track to be edited.
time is the time for the beginning of the segment to be deleted. If this
time is beyond the track duration, an error is set and DM_FAILURE is
returned.
duration is the duration of the segment to be deleted. If the end of the
segment to be deleted, as indicated by time and duration, is beyond the
track duration, an error is set and DM_FAILURE is returned.
timescale is the timescale for time and duration.
mvInsertTrackGapAtTime
This function inserts an empty segment into the track. An empty segment
is a segment that does not contain any media data. Note that gaps are not
supported in all file formats.
track is the track id of the track to be edited.
time is the time at the beginning of the empty segment to be inserted.
If this time is beyond the track duration, or less than 0, no error is
Page 1
mvDeleteFramesAtTime(3dm)mvDeleteFramesAtTime(3dm)
set and DM_SUCCESS is returned.
duration is the duration of the empty segment to be inserted.
timescale is the timescale for time and duration.
mvCopyFramesAtTime
This function copies a segment from one track to another.
srcTrack is the track id of the source track.
srcTime is the beginning of the segment of the source track to be copied.
If this value is beyond the end of the track, an error is set and
DM_FAILURE is returned.
srcDuration is the duration of the segment of the source track to be
copied. If the end of the source segment indicated by the user is beyond
the duration of the track, only the segment up to the duration of the
track is copied. If the duration is less than zero, an error is set and
DM_FAILURE is returned.
srcTimeScale is the timescale for srcTime and srcDuration.
dstTrack is the track id of the destination track.
dstTime is the time at which the segment is to be inserted into the
destination track. If this time is beyond the duration of the
destination track, an empty segment is first inserted between dstTime and
the duration of the track.
dstTimeScale is the timescale for dstTime.
byReference is the flag that determines whether the frames are to be
copied from one file to another if the srcTrack uses data in different
files. If byReference is DM_TRUE, or if the source and destination
tracks belong to the same movie, references to the data in the source
movie are created, but no media data is copied. Otherwise, the data
frames are copied into the destination movie.
SEE ALSOmvIntro(3dm), mvGetErrno(3dm), mvOptimize(3dm), mvWrite(3dm).
Page 2
