QM_SetTrackUsage

QM_SetTrackUsage(movieRef; trackID; trackUsage):error
	movieRef	Longint	Movie reference
	trackID	Longint	Track ID
	trackUsage	Longint	Track usage flags
	error	Longint	Error result

Changes the track's usage in the movie. A track can be used in the movie, in the movie's preview, poster, or any combination in these.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile.

Parameter trackID is the ID of the track.

Parameter trackUsage specifies the track's usage in the movie. The trackUsage parameter can be constructed by combining (with addition or bitwise "or") any of the following constants.

qm_TrackUsedInMovie	2	Track is used in movie
qm_TrackUsedInPreview	4	Track is used in movie preview
qm_TrackUsedInPoster	8	Track is used in poster frame

Example

`Set the usage of track ID $trackID of movie $movie to preview and poster only

C_LONGINT($trackUsage)
$trackUsage:=qm_TrackUsedInPreview | qm_TrackUsedInPoster

$err:=QM_SetTrackUsage ($movie;$trackID;$trackUsage)

Related commands

QM_GetTrackUsage

Returns the track's usage in the movie.