NAME

       voice_set_playmode - Adjusts the loop status of the specified voice. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void voice_set_playmode(int voice, int playmode);

DESCRIPTION

       Adjusts  the  loop status of the specified voice. This can be done while the voice is playing, so you can
       start a sample in looped mode (having set the loop start and end positions to  the  appropriate  values),
       and  then  clear  the  loop flag when you want to end the sound, which will cause it to continue past the
       loop end, play the subsequent part of the sample, and finish in the normal way. The mode parameter  is  a
       bitfield containing the following values:

       PLAYMODE_PLAY

       Plays the sample a single time. This is the default if you don't set the loop flag.

       PLAYMODE_LOOP

       Loops repeatedly through the sample, jumping back to the loop start position upon reaching the loop end.

       PLAYMODE_FORWARD

       Plays the sample from beginning to end. This is the default if you don't set the backward flag.

       PLAYMODE_BACKWARD

       Reverses  the  direction  of  the sample. If you combine this with the loop flag, the sample jumps to the
       loop end position upon reaching the loop start (ie. you do not need to reverse the  loop  start  and  end
       values when you play the sample in reverse).

       PLAYMODE_BIDIR

       When  used  in combination with the loop flag, causes the sample to change direction each time it reaches
       one of the loop points, so it alternates between playing forwards and in reverse.

SEE ALSO