mvFindTrack(3dm)mvFindTrack(3dm)NAME
mvFindTrackByIndex, mvFindTrackByMedium - find tracks in a movie
SYNOPSIS
#include <dmedia/moviefile.h>
DMstatus mvFindTrackByIndex( MVid id, int trackIndex, MVid *returnTrack )
DMstatus mvFindTrackByMedium( MVid movie, DMmedium medium,
MVid* returnTrack )
DESCRIPTION
These functions are used to find tracks in a movie instance.
mvFindTrackByIndex returns the track indexed by trackIndex in
returnTrack. An application can search for all of the tracks in a movie
by first using mvGetNumTracks to find the number of tracks and then
calling mvFindTrackByIndex with trackIndex ranging from zero to the
number of tracks minus one. The medium of the track can be found by
calling mvGetTrackMedium(3dm).
mvFindTrackByMedium is used to get a handle for a track of medium medium.
If a track of the given medium is present, DM_SUCCESS is returned and
returnTrack is set to the MVid for the track. If there is no such track,
DM_FAILURE is returned. When there are multiple tracks of the same
medium, mvFindTrackByMedium returns the first one it finds. In general,
applications should use mvGetNumTracks and mvFindTrackByIndex to examine
tracks.
SEE ALSOmvIntro(3dm), mvGetNumTracks(3dm), mvGetTrackMedium(3dm),
mvGetErrno(3dm).
Page 1
