mvPlayEveryFrame(3dm)                                    mvPlayEveryFrame(3dm)


NAME
     mvSetPlayEveryFrame, mvGetPlayEveryFrame - Make movies play against time
     base, or without dropping frames


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


     void mvSetPlayEveryFrame(MVid movieid, DMboolean sync);

     DMboolean mvGetPlayEveryFrame(MVid movieid);


DESCRIPTION
     mvSetPlayEveryFrame(3dm) allows you to decide whether a movie should play
     in real-time against a clock base, or should play back all frames.

     To play back every frame in sequence without dropping intervening frames,
     call mvSetPlayEveryFrame with a value of DM_TRUE for the sync parameter.

     To play back movies at the current speed, dropping frames if necessary to
     keep up with the movie's time base, call mvSetPlayEveryFrame(3dm) with a
     value of DM_FALSE for the sync parameter.  The current speed is the
     natural frame rate for the movie, as specified in the movie file,
     multiplied by the current play speed.  To change the current play speed,
     use mvSetPlaySpeed(3dm).

     When the Movie Playback Library is set to play back every frame, it
     automatically suspends audio playback.  Additionally, you will not
     receive MV_EVENT_SLOW_PLAY events when a movie is set to play back every
     frame.

     The default playback mode is always DM_FALSE.

     mvGetPlayEveryFrame(3dm) returns the current setting of
     mvSetPlayEveryFrame(3dm) for the specified movie.

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


NOTES
     In IRIX 6.3 and 6.4, when the Movie Playback Library was set to play back
     every frame, it did NOT suspect audio playback.  The Movie Playback
     Library played all audio and video unsynchronized instead. To enable this
     previously undocumented feature, set the MV_PLAYEVERY_WITH_AUDIO
     environment variable.


SEE ALSO
     mvBindOpenGLWindow(3dm), mvIntro(3dm), mvSetPlaySpeed(3dm).


                                                                        Page 2