Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGGetChannelMatrix

The SGGetChannelMatrix function allows you to retrieve a channel's display transformation matrix.

pascal ComponentResult SGGetChannelMatrix (SGChannel c, 
                                           MatrixRecord *m);

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.

m

Contains a pointer to a matrix structure, as defined by the Movie Toolbox (see "Movie Toolbox" in Inside Macintosh: QuickTime for more information about matrix structures). The channel component places its current matrix values into this matrix structure.

SEE ALSO

You may set a channel's matrix by calling the SGSetChannelMatrix function, which is discussed in the previous section.