GetMoviePict
The GetMoviePict function creates a picture from the specified movie at the specified time. This function uses only those movie tracks that are currently enabled and would therefore be used in playback. Your application may call this function even if the movie is inactive.
pascal PicHandle GetMoviePict (Movie theMovie, TimeValue time);
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).
time
- Specifies the movie image for the picture. The
time parameter contains the time from which the image is taken.
DESCRIPTION
The GetMoviePict 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
You can use the GetMoviePict function to create a picture. If the movie contains compressed data, the picture created by this function may also contain compressed data that cannot be displayed without QuickTime.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
| invalidTime | -2015 | This time value is invalid |
Image Compression Manager errors
Memory Manager errors
SEE ALSO
If you want to create a picture from a movie's preview, put the movie into preview mode by calling the SetMoviePreviewMode function (described on page 2-107), and then call the GetMoviePict function.
