MCGetClip(IM: QC)

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.