mvMapBetweenTracks(3dm)

NAME
     mvMapBetweenTracks - convert frame numbers between tracks


SYNOPSIS
     #include <dmedia/moviefile.h>


     DMstatus mvMapBetweenTracks( MVid fromTrack, MVid toTrack,
                              MVframe fromFrameIndex, MVframe* toFrameIndex )


DESCRIPTION
     Different tracks in a movie have different rates of presentation.  Frame
     number 10 of an image track may be presented at the same time as frame
     number 220500 in an audio track.  This function is used to find
     corresponding frame numbers in different tracks.

     The tracks are named by fromTrack and toTrack.  The frame number of track
     fromTrack in fromFrameIndex is converted to a frame number for track
     toTrack and placed in toFrameIndex.

     The starting times for frames in different tracks may not coincide
     exactly if the rate of one is not an exact multiple of the other.  The
     frame in toTrack that starts at or before and ends after the starting
     time of fromFrameIndex in fromTrack is the one that is returned.

     mvMapBetweenTracks returns DM_SUCCESS if there is a corresponding frame
     and DM_FAILURE if there is not.


SEE ALSO
     mvIntro(3dm), mvAddTrack(3dm), mvFindTrack(3dm), mvGetErrno(3dm).