allocate_voice(3alleg4) Allegro manual allocate_voice(3alleg4)
NAME
allocate_voice - Allocates a sound card voice for a sample. Allegro game programming library.
SYNOPSIS
#include <allegro.h>
int allocate_voice(const SAMPLE *spl);
DESCRIPTION
Allocates a sound card voice and prepares it for playing the specified sample, setting up sensible default parameters (maximum volume, cen-
tre pan, no change of pitch, no looping). When you are finished with the voice you must free it by calling deallocate_voice() or
release_voice(). Allegro can manage up to 256 simultaneous voices, but that limit may be lower due to hardware reasons.
RETURN VALUE
Returns the voice number, or -1 if no voices are available.
SEE ALSO
deallocate_voice(3alleg4), reallocate_voice(3alleg4), release_voice(3alleg4), load_sample(3alleg4)
Allegro version 4.4.2 allocate_voice(3alleg4)
