SetMovieTimeScale
The SetMovieTimeScale function establishes a movie's time scale.
pascal void SetMovieTimeScale (Movie theMovie,
TimeScale timeScale);
theMovie
- Specifies the movie for this operation. Your application obtains this movie identifier from such functions as
NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).
timeScale
- Specifies the movie's new time scale.
DESCRIPTION
In response to this request, the Movie Toolbox adjusts the edit list of the movie's tracks so that movie playback is unaffected. If you change a movie's time scale by setting it to a smaller value (thereby losing precision in the movie's time values), the Movie Toolbox may edit information from the movie. In general, you should only increase the time scale value, and you should try to use integer multiples of the existing time scale.
SPECIAL CONSIDERATIONS
Do not call SetMovieTimeScale if you have edited your movie. This function quantizes the beginning and the end of the edits to the new units. Therefore, if you do not use an integral multiple, the position of your edits may change.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
You can retrieve a movie's time scale by calling the GetMovieTimeScale function, which is described in the next section.
