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


     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 ALSO
     mvIntro(3dm), mvGetErrno(3dm), mvOptimize(3dm), mvWrite(3dm).


                                                                        Page 2