Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

SetMovieGWorld

The SetMovieGWorld function allows your application to establish a movie's display coordinate system by setting the graphics world for displaying a movie.

pascal void SetMovieGWorld (Movie theMovie, CGrafPtr port,
                            GDHandle gdh);

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).

port

Points to the movie's graphics port structure or graphics world. Set this parameter to nil to use the current graphics port.

gdh

Contains a handle to the movie's graphics device structure. Set this parameter to nil to use the current device. If the port parameter specifies a graphics world, set this parameter to nil to use that graphics world's graphics device.

DESCRIPTION

The default cover function provided by the Movie Toolbox uses the background color and pattern from the movie's graphics world during erase operations.

SPECIAL CONSIDERATIONS

The Movie Toolbox automatically sets the graphics world when you create a new movie. Be sure that your application's graphics port is valid or that you specify a valid graphics port with the port parameter. If you pass nil for the port parameter, make sure the current graphics world is valid.

When you use SetMovieGWorld, the Movie Toolbox remembers the current background color and background pattern. These are used for erasing in the default movie uncover function.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can retrieve a movie's graphics world by calling the GetMovieGWorld function, which is described in the next section.