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