Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / General Data Management

MediaSetMovieTimeScale

The MediaSetMovieTimeScale function allows the Movie Toolbox to inform your media handler that the movie's time scale has been changed.

pascal ComponentResult MediaSetMovieTimeScale 
                                    (ComponentInstance ci,
                                     TimeScale newTimeScale);

ci

Identifies the Movie Toolbox's connection to your derived media handler.

newTimeScale

Specifies the movie's new time scale.

DESCRIPTION

The Movie Toolbox calls your derived media handler's MediaSetMovieTimeScale function whenever the movie's time scale is changed. Applications can change the movie's time scale by using the Movie Toolbox's SetMovieTimeScale function. When the Movie Toolbox calls this function, your media handler should recalculate any time values you have stored that are expressed in the movie's time coordinate system. Changing the movie's time scale may also affect playback of your media.

You obtain the initial movie time scale information from the movieScale field of the movie parameter structure that the Movie Toolbox provides to your MediaInitialize function.

Your derived media handler should support this function if your media handler stores time information in the movie's time coordinate system.

RESULT CODES

Any Component Manager result code