SetMoviePreviewMode
The SetMoviePreviewMode function allows your application to place a movie into and out of preview mode. When a movie is in preview mode, only those tracks identified as preview tracks are serviced. You specify how a track is used by calling the SetTrackUsage function, which is described on page 2-102.
pascal void SetMoviePreviewMode (Movie theMovie,
Boolean usePreview);
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).
usePreview
-
Specifies the movie's mode. Set this parameter to true to place the movie into preview mode. Set this parameter to false to place the movie into normal playback mode.
DESCRIPTION
When you place a movie into preview mode, the Movie Toolbox sets the active movie segment to be the preview segment of the movie. When you take a movie out of preview mode and place it back in normal playback mode, the toolbox sets the active movie segment to be the entire movie. For information about working with active movie segments, see "Enhancing Movie Playback Performance" beginning on page 2-119.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
