Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

SetMoviePreviewTime

The SetMoviePreviewTime function allows your application to define the starting time and duration of the movie's preview. These time values are in the movie's time coordinate system.

pascal void SetMoviePreviewTime (Movie theMovie, 
                                 TimeValue previewTime, 
                                 TimeValue previewDuration);

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).

previewTime

Contains a time value that specifies the preview's starting time.

previewDuration

Contains a time value that specifies the preview's duration.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidDuration	-2014	This duration value is invalid
invalidTime	-2015	This time value is invalid

SEE ALSO

Your application can retrieve the starting time and duration of the preview with the GetMoviePreviewTime function, which is described in the next section.