QMedia Movie editing commands

QM_InsertMovieSegment

QM_InsertMovieSegment(srcMovieRef; destMovieRef; srcTime; srcDuration; destTime):error
	srcMovieRef	Longint	Source movie reference
	destMovieRef	Longint	Destination movie reference
	srcTime	Longint	Source segment start
	srcDuration	Longint	Source segment duration
	destTime	Longint	Insertion point in destination movie
	error	Longint	Error result

Inserts part of a movie 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.

The source and destination movie references may refer to the same movie file, or to different movie files. If the source and destination movie files are different, new tracks may be added to the destination movie.

QuickTime always tries to use existing tracks to store the data. Before adding a new track, QuickTime looks in the destination movie for tracks with the same characteristics as the source track. If such a track is found, it is used for the copy operation; otherwise, a new track is created in the destination movie.

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

Parameter destTime specifies the insertion point in the destination movie. It must be expressed in the destination movie's time scale. Parameter destTime may specify a point beyond the end of the movie. In that case, QuickTime inserts empty space as appropriate.

Related commands