mvDeleteFramesAtTime(3dm)			     mvDeleteFramesAtTime(3dm)

NAME    [Toc]    [Back]

     mvInsertTrackGapAtTime mvDeleteFramesAtTime, mvCopyFramesAtTime -
     edit/manipulate a movie track

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     mvIntro(3dm), mvGetErrno(3dm), mvOptimize(3dm), mvWrite(3dm).


									PPPPaaaaggggeeee 2222