Inside Macintosh: QuickTime Reference

New Movie Track and Movie Wired Actions

Two new actions operate on a movie track target:

kActionMovieTrackAddChildMovie (QTAtomID childMovieID, CStr childMovieURL)

This action adds a new movie URL data reference to the targeted movie track's array of movie data references. The URL data reference is added with the specified ID. If a data reference with the same ID already exists, it is replaced. It is generally a good idea to use an ID that is not contained in the movie track's sample, since this may be reloaded under some conditions.

kActionMovieTrackLoadChildMovie (QTAtomID childMovieID)

This action loads a movie specified by childMovieID as the current movie being played by the movie track. The movie replaces the current movie.

Another new action operates on a root movie or a movie track target:

kActionMovieRestartAtTime (TimeValue startTime, Fixed rate)

This action restarts the targeted movie at the specified movie time, restarting it at the specified rate. If rate is set to zero, then the current movie rate is used. More specifically, this action stops the current movie, changes the movie's time to the specified time, and then prerolls the movie from that time at the specified rate.

Note that the wired actions DoScript, GotoURL, DebugString, and StatusString are sent through the root movie's MCDoActionProc when executed from a child movie, allowing them to work with existing applications that trap for these actions.

Inside Macintosh: QuickTime Reference