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

QM_InsertEmptyMovieSegment | Inserts an empty segment into a movie.
QM_DeleteMovieSegment | Removes a segment from a movie.

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