SetTrackAlternate
The SetTrackAlternate function allows your application to add tracks to or remove tracks from alternate groups.
pascal void SetTrackAlternate (Track theTrack, Track alternateT);
theTrack
- Specifies the track and group for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively). The SetTrackAlternate function changes this track's group affiliation based on the value of the alternateT parameter.
alternateT
- Controls whether the function adds the track to a group or removes it from a group. If the
alternateT parameter contains a valid track identifier, the Movie Toolbox adds this track to the group that contains the track specified by the parameter theTrack. Note that if the track identified by the parameter alternateTrack already belongs to a group, the Movie Toolbox combines the two groups into a single group.
-
- Set this parameter to
nil to remove the track specified by the theTrack parameter from its group.
ERROR CODES
| invalidTrack | -2009 | This track is corrupted or invalid |
SEE ALSO
You can determine all the tracks in a group by calling the GetTrackAlternate function, which is described in the next section.
