SetMovieMatrix
The SetMovieMatrix function allows your application to set a movie's transformation matrix. The Movie Toolbox uses a movie's matrix to map a movie from its display coordinate system to its graphics world. You can retrieve a movie's matrix with the GetMovieMatrix function, which is described in the next section.
pascal void SetMovieMatrix (Movie theMovie,
const MatrixRecord *matrix);
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).
matrix
- Contains a pointer to the matrix structure for the movie. If you set this parameter to
nil, the Movie Toolbox uses the identity matrix.
SPECIAL CONSIDERATIONS
The SetMovieMatrix function does not call your cover functions.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
The Movie Toolbox provides a number of functions that allow you to manipulate movie matrices. See "Matrix Functions," which begins on page 2-321, for information about these functions.
