SetMoviePosterTime
The SetMoviePosterTime function sets the poster time for the movie. Since a movie poster is a still frame, it is defined by a point in time within the movie. The poster's time is expressed in the movie's time coordinate system. Your application can retrieve a poster's time by calling the GetMoviePosterTime function, which is described in the next section.
pascal void SetMoviePosterTime (Movie theMovie,
TimeValue posterTime);
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).
posterTime
-
Contains the starting time for the movie frame that contains the poster image.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
| invalidTime | -2015 | This time value is invalid |
SEE ALSO
Your application can set the poster's boundary rectangle by calling the SetPosterBox function, which is described on page 2-103.
