SetTrackClipRgn
The SetTrackClipRgn function allows your application to set the clipping region of a track.
pascal void SetTrackClipRgn (Track theTrack, RgnHandle theClip);
theTrack
- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).
theClip
- Contains a handle to the track's clipping region. Note that the Movie Toolbox makes a copy of this region. Your application must dispose of the region referred to by this parameter when you are done with it. Set this parameter to
nil to disable clipping for the track.
DESCRIPTION
The clipping region is in the track's coordinate system. The Movie Toolbox applies the clipping region to a track before it applies the track's matrix.
ERROR CODES
| invalidTrack | -2009 | This track is corrupted or invalid |
Memory Manager errors
SEE ALSO
You can get a track's clipping region by calling the GetTrackClipRgn function, which is described in the next section.
