.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.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[R]
.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
If you call this function a second time with a smaller number of
samples, then the excess internal sample instances will be destroyed
causing some sounds to stop and some instances returned by
al_lock_sample_id(3alleg5) to be invalidated.
.PP
This diagram illustrates the structures that are set up:
.IP
.nf
\f[C]
                                      sample instance 1
                                    / sample instance 2
default voice <-- default mixer <---         .
                                    \[rs]        .
                                      sample instance N
\f[R]
.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)