Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Associating Movies With Controllers

MCSetMovie

The MCSetMovie function associates a movie with a specified movie controller.

pascal ComponentResult MCSetMovie (MovieController mc, 
                                    Movie theMovie,
                                    WindowPtr movieWindow, 
                                    Point where);

mc

Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).

theMovie

Identifies the movie to be associated with the movie controller. Set this value to nil to remove the movie from the controller.

movieWindow

Identifies the window in which the movie is to be displayed. The movie controller component sets the movie's graphics world to match this window. If you set the w parameter to nil, the component uses the current window.

where

Specifies the upper-left corner of the movie within the window specified by the movieWindow parameter. The movie controller component uses the movie's boundary rectangle to determine the size of the movie (the Movie Toolbox's GetMovieBox function returns this rectangle).

DESCRIPTION

You can also use the MCSetMovie function to remove a movie from its controller.

SEE ALSO

If you want to scale the movie, call the Movie Toolbox's SetMovieBox function (described in Inside Macintosh: QuickTime) before calling MCSetMovie.