mvPlay(3dm)                                                        mvPlay(3dm)


NAME
     mvPlay, mvStop, mvIsMovieStopped - Start and stop movie playback


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


     void mvPlay(MVid movieid);

     void mvStop(MVid movieid);

     DMboolean mvIsMovieStopped(MVid movieid);


DESCRIPTION
     change any playback parameters associated with the movie, such as speed
     and direction of playback.  For example, if you change the speed of movie
     playback, then call mvPlay(3dm), the movie plays at the speed you had
     just set.   If the movie is already playing, mvPlay(3dm) has no effect.

     mvStop(3dm) stops movie playback.  If you have requested MV_EVENT_STOP
     events, the Movie Playback Library will send a MV_EVENT_STOP event to
     you.  You will receive a MV_EVENT_STOP event only if the movie was
     actually playing when mvStop(3dm) was called.  If the movie is already
     stopped, mvStop(3dm) has no effect.

     mvIsMovieStopped(3dm) returns whether or not the movie is stopped
     (DM_TRUE) or currently playing (DM_FALSE).

     You may only call mvPlay(3dm) and mvStop(3dm) functions for a specified
     movie while it is bound to a window (see mvBindOpenGLWindow(3dm)).


SEE ALSO
     mvIntro(3dm), mvBindOpenGLWindow(3dm), mvPlayAt(3dm),
     mvSetPlayEveryFrame(3dm), mvSetFrame(3dm), mvSetPlayLoopMode(3dm),
     mvSetPlaySpeed(3dm).


                                                                        Page 1