QMedia Movie editing commands

QM_InsertTrackSegment

QM_InsertTrackSegment(srcMovieRef; srcTrackID; destMovieRef; destTrackID; srcTime; srcDuration; destTime; copyRefs):error
srcMovieRef Longint Source movie reference
srcTrackID Longint Source track ID
destMovieRef Longint Destination movie reference
destTrackID Longint Destination track ID
srcTime Longint Source segment start
srcDuration Longint Source segment duration
destTime Longint Insertion point in destination track
copyRefs Longint Copy media references
error Longint Error result

Inserts part of a track into another.

Parameters srcMovieRef and destMovieRef are the references to the source and destination movie instances respectively. The source movie reference must have been previously obtained with a call to QM_NewMovieFromFile or QM_NewMovieFromURL. The destination movie reference must have been previously obtained with a call to QM_NewMovieFromFile.

Parameters srcTrackID and destTrackID are the IDs of the source and destination tracks respectively.

It is possible to copy data within the same track. To do this, srcMovieRef and destMovieRef must refer to the same movie file, and srcTrackID and destTrackID must specify the same track.

If the source and destination tracks are not the same, they must contain media of the same type.

Parameters srcTime and srcDuration specify the starting point and duration of the source track segment. Both must be expressed in the source movie's time scale.

Parameter destTime specifies the insertion point in the destination track. It must be expressed in the destination movie's time scale.

Parameter copyRefs specifies whether QM_InsertTrackSegment will insert a reference to the source media, or a copy the media data. If copyRefs is set to 1, QM_InsertTrackSegment will insert a reference, otherwise the source media data will be copied to the destination movie.

Related commands

QM_InsertEmptyTrackSegment Inserts an empty segment into a track.
QM_DeleteTrackSegment Removes a segment from a track.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:41:35