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);
DESCRIPTIONmvSetPlayLoopMode(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
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 ALSOmvIntro(3dm), mvPlay(3dm), mvStop(3dm), mvSetPlaySpeed(3dm),
mvSetStartFrame(3dm), mvSetEndFrame(3dm).
Page 2
