Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCGetClip

The MCGetClip function allows you to obtain information describing a movie controller's clipping regions.

pascal ComponentResult MCGetClip (MovieController mc, 
                                  RgnHandle *theClip, 
                                  RgnHandle *movieClip);

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

theClip

Contains a pointer to a field that is to receive a handle to the clipping region of the entire movie controller. You must dispose of this region when you are done with it. If you are not interested in this information, you may set this parameter to nil.

movieClip

Contains a pointer to a field that is to receive a handle to the clipping region of the controller's movie. You must dispose of this region when you are done with it. If you are not interested in this information, you may set this parameter to nil.

RESULT CODES

Memory Manager errors

SEE ALSO

You can set a controller's clipping information by calling the MCSetClip function, which is described in the previous section.