mvPlayLoop(3dm)                                                mvPlayLoop(3dm)


NAME
     mvSetPlayLoopMode, mvGetPlayLoopMode, mvSetPlayLoopLimit,
     mvGetPlayLoopLimit, mvSetPlayLoopCount, mvGetPlayLoopCount - Set/get
     movie playback loop mode, limit, and count.


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


     void mvSetPlayLoopMode(MVid movieId, MVloopmode newLoopMode);

     MVloopmode mvGetPlayLoopMode(MVid movieId);

     void mvSetPlayLoopLimit(MVid movieId, MVframe newLoopLimit);

     MVframe mvGetPlayLoopLimit(MVid movieId);

     void mvSetPlayLoopCount(MVid movieId,  MVframe newLoopCount);

     MVframe mvGetPlayLoopCount(MVid movieId);


DESCRIPTION
     mvSetPlayLoopMode(3dm) determines whether Movie Playback Library should
     play the specified movie once, loop repeatedly, or swing forwards and
     backwards.  This call will override, for playback purposes only, any
     looping information which may be present in the movie file.  For file
     formats which support loop mode information, Movie Playback Library
     obtains the default setting from the movie file.  For other file formats,
     the default is MV_LOOP_NONE.

     mvGetPlayLoopMode(3dm) returns the current loop mode state for the
     specified movie.

     Note that if you change the loop mode, no other playback parameters are
     affected.  For example, if the movie is playing backwards, and you change
     the loop mode from MV_LOOP_SWINGING to MV_LOOP_CONTINUOUSLY, the movie
     will play continuously, but backwards.

     mvSetPlayLoopLimit(3dm) sets the maximum number of times to loop or swing
     playback.  Movie Playback Library will stop the movie when the limit is
     reached.  To play a movie forever, use MV_LIMIT_FOREVER for the loop
     limit. The default loop limit is always MV_LIMIT_FOREVER.

     For swinging movies, each trip forwards or backwards through the movie
     counts as a complete run of the movie.  For example, if the limit for a
     movie is 3 and the movie is swinging, it will play forwards twice and
     backwards once, and then stop (or backwards twice and forwards once,
     depending on the direction in which it started playing).


     mvGetPlayLoopLimit(3dm) returns the current loop limit for the specified
     movie.

     mvSetPlayLoopCount(3dm) sets the number of times the specified movie
     instance has repeated playback so far.  Movie Playback Library will stop
     the movie when this count matches the movie's loop limit.  To change the
     movie's loop limit, use mvSetPlayLoopLimit(3dm).  The default loop count
     is always 0.

     mvGetPlayLoopCount(3dm) returns the current loop count for the specified
     movie.

     To loop or swing over a portion of the movie, use the
     mvSetStartFrame(3dm) and mvSetEndFrame(3dm) calls to choose the start and
     end of the clip you wish to show.

     You may invoke all of these calls on a movie regardless of whether or not
     the movie is currently playing.

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


SEE ALSO
     mvIntro(3dm), mvPlay(3dm), mvStop(3dm), mvSetPlaySpeed(3dm),
     mvSetStartFrame(3dm), mvSetEndFrame(3dm).


                                                                        Page 2