GetMoviePosterPict
The GetMoviePosterPict function creates a picture that contains a movie's poster.
pascal PicHandle GetMoviePosterPict (Movie theMovie);
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).
DESCRIPTION
The GetMoviePosterPict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil.
SPECIAL CONSIDERATIONS
If you have not assigned a poster time for the movie, the Movie Toolbox creates the poster from the movie image that corresponds to a time value of 0.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
Image Compression Manager errors
Memory Manager errors
