Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGGetChannelClip

The SGGetChannelClip function allows you to retrieve a channel's clipping region.

pascal ComponentResult SGGetChannelClip (SGChannel c, 
                                          RgnHandle *theClip);

c

Identifies the channel for this operation. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, described on page 5-29 and page 5-30, respectively.

theClip

Contains a pointer to a handle that is to receive the clipping region. Your application is responsible for disposing of this handle. If there is no clipping region, the channel component sets this handle to nil.

Note

Some devices may not support clipping.

SEE ALSO

You may set a channel's clipping region by calling the SGSetChannelClip function, which is discussed in the previous section.