Movies and Your Event Loop(IM:Q)

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies

Movies and Your Event Loop
In order for your movies to play, your application must grant time to the Movie Toolbox. You do this by calling the MoviesTask function from your main event loop. The MoviesTask function causes the Movie Toolbox to service all your active movies. You should call this function regularly so that your movie can play smoothly. You can use the UpdateMovie function to force your movie to be redrawn after it has been uncovered.
You may want your application to take a particular action when a movie is done playing. The Movie Toolbox provides the IsMovieDone function, which allows you to determine whether a movie is done playing. The Movie Toolbox also provides more sophisticated callback mechanisms, which are discussed in "Time Base Functions" beginning on page 2-296.
The Movie Toolbox provides two functions that allow your application to determine whether a specified point lies in either a movie or a track. Use the PtInMovie function with movies; use the PtInTrack function with tracks.
Your application can retrieve some status information about movies and tracks. Use the GetMovieStatus function to retrieve movie status; use the GetTrackStatus function to get track status.

Subtopics

MoviesTask

IsMovieDone

UpdateMovie

PtInMovie

PtInTrack

GetMovieStatus

GetTrackStatus