mvCurrentTime(3dm)                                          mvCurrentTime(3dm)


NAME
     mvSetCurrentTime, mvGetCurrentTime - Set/get the time which is currently
     playing


SYNOPSIS
     #include <dmedia/moviefile.h>
     #include <dmedia/movieplay.h>


     DMstatus mvSetCurrentTime(MVid movieId, MVtime curTime, MVtimescale timeScale);

     MVtime mvGetCurrentTime(MVid movieId, MVtimescale timeScale);


DESCRIPTION
     mvSetCurrentTime(3dm) tells the Movie Playback Library what the current
     time in the movie is.  This call causes the playback to jump to that time
     in the movie.  If curTime is less than 0 or greater than the value
     returned by mvGetEstMovieDuration(timeScale), then DM_FAILURE is returned
     and the movie errno is set to MV_TIME_OUT_OF_RANGE.

     mvGetCurrentTime(3dm) returns the current time being played.  If the
     movie is stopped, this is the time corresponding to the currently
     displayed image.  If the movie is playing, this is a time close to the
     currently displayed image.  For more precise synchronization information,
     see mvGetMovieSyncInfo or listen for MV_EVENT_SYNC events (see
     mvEvent(3dm)).

     These calls may be made whether or not the movie is currently playing.


BUGS
     These calls can easily be confused with the Movie File Library calls
     mvGetMovieCurrentTime() and mvSetMovieCurrentTime().  Those calls only
     work on movie files and will not affect the currently played time.


SEE ALSO
     mvBindOpenGLWindow(3dm), mvGetErrno(3dm), mvGetEstMovieDuration(3dm),
     mvIntro(3dm), mvPlay(3dm), mvPort(3dm).  mvSetMovieCurrentTime(3dm),
     mvSetPlayLoopMode(3dm), mvStop(3dm).


                                                                        Page 1