mvPlayLoop(3dm)						       mvPlayLoop(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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).




									Page 1






mvPlayLoop(3dm)						       mvPlayLoop(3dm)



     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
     mvSetStartFramemvBindOpenGLWindow(3dm)).

SEE ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222