---

Time and Space Function Summary

Here is a summary of the Movie Toolbox functions you can use to manage movie time and spatial characteristics.

In this section:

Managing Movie Space
Working With Matrices
Managing Movie Time
Managing Track Time
Managing Media Time
Finding Interesting Times
Time Base Management

Managing Movie Space

The Movie Toolbox contains a number of functions that your application can use to determine or change the spatial display characteristics of movies and tracks. These functions affect the movie’s graphics world, its matrix, the final display coordinate system, and the display boundaries. They include

• SetTrackGWorld

• SetMovieGWorld

• GetMovieGWorld

• SetMovieBox

• GetMovieBox

• GetMovieDisplayBoundsRgn

• GetMovieSegmentDisplayBoundsRgn

• SetMovieDisplayClipRgn

• GetMovieDisplayClipRgn

• GetTrackSegmentDisplayBoundsRgn

• SetTrackLayer

• GetTrackLayer

• SetMovieMatrix

• GetMovieMatrix

• GetMovieBoundsRgn

• GetTrackMovieBoundsRgn

• GetMovieClipRgn

• SetTrackMatrix

• GetTrackMatrix

• GetTrackBoundsRgn

• SetTrackDimensions

• GetTrackDimensions

• SetTrackClipRgn

• GetTrackClipRgn

• SetTrackMatte

• GetTrackMatte

• DisposeMatte

• SetMovieColorTable

• GetMovieColorTable

Working With Matrices

Several Movie Toolbox functions allow you to manipulate transformation matrices.

• SetIdentityMatrix

• GetMatrixType

• CopyMatrix

• EqualMatrix

• TranslateMatrix

• ScaleMatrix

• RotateMatrix

• SkewMatrix

• ConcatMatrix

• InverseMatrix

• TransformPoints

• TransformFixedPoints

• TransformRect

• TransformFixedRect

• TransformRgn

• RectMatrix

• MapMatrix

Managing Movie Time

Several functions are used to work with a movie’s time parameters. Included are functions for retrieving the time base, working with the current movie time, working with the time scale, calculating the movie’s duration, and getting and setting the playback rate.

• GetMovieDuration

• SetMovieTimeValue

• SetMovieTime

• GetMovieTime

• SetMovieRate

• GetMovieRate

• SetMovieTimeScale

• GetMovieTimeScale

• GetMovieTimeBase

Managing Track Time

Several functions work with a track’s time parameters. All tracks share the movie’s time base, but each track contains its own offset and duration. A function is also provided to translate track time into a value appropriate to the track’s media.

• GetTrackDuration

• SetTrackOffset

• GetTrackOffset

• TrackTimeToMediaTime

Managing Media Time

Three functions work with a media’s time parameters. Each media has its own time scale and duration.

• GetMediaDuration

• SetMediaTimeScale

• GetMediaTimeScale

Finding Interesting Times

You can call Movie Toolbox functions to search a movie, track or media for a particular sample, such as a keyframe. The functions return the time and duration of the next sample that meets the search criteria.

• GetMovieNextInterestingTime

• GetTrackNextInterestingTime

• GetMediaNextInterestingTime

Time Base Management

Various Movie Toolbox functions work with time bases. A QuickTime time base defines the time coordinate system for a movie. It can also be used to provide general timing services.

• Creating and Disposing of Time Bases

  • NewTimeBase

  • DisposeTimeBase

  • SetMovieMasterClock

  • SetMovieMasterTimeBase

  • SetTimeBaseMasterClock

  • GetTimeBaseMasterClock

  • SetTimeBaseMasterTimeBase

  • GetTimeBaseMasterTimeBase

  • SetTimeBaseZero

• Working With Time Base Values

  • SetTimeBaseTime

  • SetTimeBaseValue

  • SetTimeBaseRate

  • GetTimeBaseRate

  • GetTimeBaseEffectiveRate

  • SetTimeBaseStartTime

  • GetTimeBaseStartTime

  • SetTimeBaseStopTime

  • GetTimeBaseStopTime

  • SetTimeBaseFlags

  • GetTimeBaseFlags

  • GetTimeBaseStatus

• Time Structures

  • AddTime

  • SubtractTime

  • ConvertTime

  • ConvertTimeScale

• Time Base Callback Functions

  • NewCallBack

  • CallMeWhen

  • CancelCallBack

  • DisposeCallBack

  • GetCallBackTimeBase

  • GetCallBackType

Most of these functions are discussed in the preceding sections of this chapter.

---