.\" 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_create_voice" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_create_voice - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_audio.h>

ALLEGRO_VOICE *al_create_voice(unsigned int freq,
   ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
\f[R]
.fi
.SH DESCRIPTION
.PP
Creates a voice structure and allocates a voice from the digital sound
driver.
The passed frequency (in Hz), sample format and channel configuration
are used as a hint to what kind of data will be sent to the voice.
However, the underlying sound driver is free to use non-matching values.
For example, it may be the native format of the sound hardware.
.PP
If a mixer is attached to the voice, the mixer will handle the
conversion of all its input streams to the voice format and care does
not have to be taken for this.
However if you access the voice directly, make sure to not rely on the
parameters passed to this function, but instead query the returned voice
for the actual settings.
.PP
Reasonable default arguments are:
.IP
.nf
\f[C]
al_create_voice(44100, ALLEGRO_AUDIO_DEPTH_INT16, ALLEGRO_CHANNEL_CONF_2)
\f[R]
.fi
.SH SEE ALSO
.PP
al_destroy_voice(3alleg5)