.\" Automatically generated by Pandoc 1.17.2
.\"
.TH "al_reserve_samples(3alleg5) Allegro reference manual" "" "" "" ""
.hy
.SH NAME
.PP
al_reserve_samples \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro_audio.h>

bool\ al_reserve_samples(int\ reserve_samples)
\f[]
.fi
.SH DESCRIPTION
.PP
Reserves a number of sample instances, attaching them to the default
mixer.
If no default mixer is set when this function is called, then it will
create one and attach it to the default voice.
If no default voice has been set, it, too, will be created.
.PP
This diagram illustrates the structures that are set up:
.IP
.nf
\f[C]
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sample\ instance\ 1
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ /\ sample\ instance\ 2
default\ voice\ <\-\-\ default\ mixer\ <\-\-\-\ \ \ \ \ \ \ \ \ .
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \\\ \ \ \ \ \ \ \ .
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sample\ instance\ N
\f[]
.fi
.PP
Returns true on success, false on error.
al_install_audio(3alleg5) must have been called first.
.SH SEE ALSO
.PP
al_set_default_mixer(3alleg5), al_play_sample(3alleg5)