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

ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)
\f[R]
.fi
.SH DESCRIPTION
.PP
Loads and plays an audio file from ALLEGRO_FILE(3alleg5) stream as it is
needed.
.PP
The file type is determined by the passed `ident' parameter, which is a
file name extension including the leading dot.
.PP
Returns the stream on success, NULL on failure.
You must not destroy the returned stream, it will be automatically
destroyed when the addon is shut down.
On success the file should be considered owned by the audio stream, and
will be closed when the audio stream is destroyed.
On failure the file will be closed.
.RS
.PP
\f[I]Note:\f[R] the allegro_audio library does not support any audio
file formats by default.
You must use the allegro_acodec addon, or register your own format
handler.
.RE
.SH SEE ALSO
.PP
al_play_audio_stream(3alleg5), al_load_audio_stream_f(3alleg5)
.SH SINCE
.PP
5.2.8
.RS
.PP
\f[I][Unstable API]:\f[R] New API.
.RE