SetAutoTrackAlternatesEnabled
The SetAutoTrackAlternatesEnabled function allows your application to enable and disable automatic track selection by the Movie Toolbox.
pascal void SetAutoTrackAlternatesEnabled (Movie theMovie,
Boolean enable);
theMovie
- Specifies the movie for this operation. Your application obtains this movie identifier from such functions as
NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).
enable
- Controls automatic track selection. Set this parameter to
true to enable automatic track selection. Set this parameter to false to disable automatic track selection.
DESCRIPTION
If automatic track selection is enabled, the Movie Toolbox selects appropriate tracks whenever your application calls the SetMovieGWorld, SetMovieBox, UpdateMovie, or SetMovieMatrix functions (described on page 2-145, page 2-146, page 2-112, and page 2-155, respectively). When you enable automatic track selection, the Movie Toolbox immediately selects enabled tracks for the movie. This overrides the setting of the newMovieDontAutoAlternate flag (see page 2-79 for details on this flag).
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
You can instruct the Movie Toolbox to select appropriate tracks immediately by calling the SelectMovieAlternates function, which is described in the previous section.
