GetPosterBox
The GetPosterBox function allows you to obtain a poster's boundary rectangle.
pascal void GetPosterBox (Movie theMovie, Rect *boxRect);
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).
boxRect
- Contains a pointer to a rectangle. The Movie Toolbox returns the poster's boundary rectangle into the structure referred to by this parameter.
DESCRIPTION
When you call GetPosterBox without having called SetPosterBox, the current movie matrix is applied to the poster tracks to determine the poster box.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
You set the poster's boundary rectangle by calling the SetPosterBox function, which is described in the previous section.
