Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Video Channels

SGSetFrameRate

The SGSetFrameRate function allows you to specify a video channel's frame rate for recording.

pascal ComponentResult SGSetFrameRate (SGChannel c, 
                                       Fixed frameRate);

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, discussed on page 5-29 and page 5-30, respectively.

frameRate

Specifies the desired frame rate. Set this parameter to 0 to select the channel's default frame rate. Typically, this corresponds to the fastest rate that the channel can support.

DESCRIPTION

The SGSetFrameRate function allows you to control a video channel's frame rate. Note that the digitizing hardware may not be able to support the full rate you specify. If you specify too high a rate, the sequence grabber operates at the highest rate that it can support. Note that you may not call this function when you are recording.

RESULT CODES

paramErr	-50	Invalid parameter value
cantDoThatInCurrentMode	-9402	Request invalid in current mode

SEE ALSO

You can retrieve a channel's current frame rate by calling the SGGetFrameRate function, which is described next.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help