SetTrackUsage
The SetTrackUsage function allows your application to specify whether a track is used in a movie, its preview, its poster, or a combination of these.
pascal void SetTrackUsage (Track theTrack, long usage);
theTrack
- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).
usage
- Contains flags that specify how the track is to be used. The following flags are defined (be sure to set unused flags to 0):
trackUsageInMovie
- The track is used in the movie. If this flag is set to 1, the track is used in the movie.
trackUsageInPreview
- The track is used in the preview. If this flag is set to 1, the track is used in the preview.
trackUsageInPoster
- The track is used in the poster. If this flag is set to 1, the track is used in the poster.
ERROR CODES
| invalidTrack | -2009 | This track is corrupted or invalid |
SEE ALSO
Your application can determine how a track is used by calling the GetTrackUsage function, which is described in the next section.