GetTrackPict
The GetTrackPict function creates a QuickDraw picture from the specified track at the specified time. This function is similar to the GetMoviePict function (described on page 2-134), except that GetTrackPict uses only the specified track to create the picture.
pascal PicHandle GetTrackPict (Track theTrack, TimeValue time);
theTrack
- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).
time
- Specifies the track image for the picture. The
time parameter contains the time from which the image is taken.
DESCRIPTION
The GetTrackPict 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 specify a disabled track. If the track contains compressed data, the picture created by this function may also contain compressed data that cannot be displayed without QuickTime.
ERROR CODES
| invalidTrack | -2009 | This track is corrupted or invalid |
| invalidTime | -2015 | This time value is invalid |
Image Compression Manager errors
Memory Manager errors
