Working With Movie Spatial Characteristics
The Movie Toolbox provides a number of functions that allow your application to determine and change the display characteristics of movies and tracks. These functions are discussed in the following sections. Before using any of these functions, you should be familiar with the way in which the Movie Toolbox displays movies. See the discussion of spatial properties in "About Movies" on page 2-11.You can use the
SetMovieGWorldandGetMovieGWorldfunctions to work with a movie's graphics world. See Inside Macintosh: Imaging for more information about graphics worlds.Your application can work with a movie's matrix by calling the
GetMovieMatrixandSetMovieMatrixfunctions, and it can work with a track's matrix with theGetTrackMatrixandSetTrackMatrixfunctions. Then you can perform operations on matrices with the Movie Toolbox's matrix functions described in "Matrix Functions" beginning on page 2-321.The following functions affect the displayed movie and its tracks in the final display coordinate system. The
SetMovieGWorldandGetMovieGWorldfunctions let you work with a movie's display destination. TheGetMovieBoxandSetMovieBoxfunctions allow you to work with a movie's boundary rectangle and its associated transformations. Alternatively, you can use theGetMovieMatrixandSetMovieMatrixfunctions to work directly with a movie's transformation matrix. TheGetMovieDisplayBoundsRgnfunction determines a movie's boundary region at the current movie time. On the other hand, theGetMovieSegmentDisplayBoundsRgnfunction determines a movie's boundary region over a specified time segment. You can use theGetMovieDisplayClipRgnandSetMovieDisplayClipRgnfunctions to work with a movie's display clipping region.The
GetTrackDisplayBoundsRgnandGetTrackSegmentDisplayBoundsRgnfunctions determine a track's final boundary region. You can use theGetTrackLayerandSetTrackLayerfunctions to control the drawing order of tracks within a movie.A number of functions affect a movie's display boundaries before any display transformations--these functions operate in the movie's display coordinate system. You can use the
GetMovieClipRgnandSetMovieClipRgnfunctions to work with a movie's clipping region--that is, the clipping region that is applied before the movie display transformation. Use theGetMovieBoundsRgnfunction to determine a movie's boundary region at the current movie time.Use the
GetTrackMovieBoundsRgnfunction to work with a track's boundary region after matrix transformations have placed the track into the movie's display system. TheSetTrackMatrixandGetTrackMatrixfunctions let you define a track's matrix transformations.The Movie Toolbox provides several functions that affect a track's display boundaries--these functions operate in the track's display coordinate system before any other display transformations are applied. The
GetTrackDimensionsandSetTrackDimensionsfunctions allow you to establish a track's coordinate system and to establish a track's source rectangle.
You can use the
- Note
- A track's source rectangle defines the coordinate system of the track. You specify the dimensions of the rectangle by providing the coordinates of the lower-right corner of the rectangle. The Movie Toolbox sets the upper-left corner to (0,0) in the track's coordinate system.
GetTrackBoundsRgnfunction to determine a track's boundary region. TheGetTrackClipRgnandSetTrackClipRgnfunctions let you work with a track's clipping region. You can use theGetTrackMatteandSetTrackMattefunctions to establish a track's matte. TheDisposeMattefunction allows you to dispose of a matte once you are finished with it.
Subtopics
- SetMovieGWorld
- GetMovieGWorld
- SetMovieBox
- GetMovieBox
- GetMovieDisplayBoundsRgn
- GetMovieSegmentDisplayBoundsRgn
- SetMovieDisplayClipRgn
- GetMovieDisplayClipRgn
- GetTrackDisplayBoundsRgn
- GetTrackSegmentDisplayBoundsRgn
- SetTrackLayer
- GetTrackLayer
- SetMovieMatrix
- GetMovieMatrix
- GetMovieBoundsRgn
- GetTrackMovieBoundsRgn
- SetMovieClipRgn
- GetMovieClipRgn
- SetTrackMatrix
- GetTrackMatrix
- GetTrackBoundsRgn
- SetTrackDimensions
- GetTrackDimensions
- SetTrackClipRgn
- GetTrackClipRgn
- SetTrackMatte
- GetTrackMatte
- DisposeMatte