1al_load_audio_stream_f(3) al_load_audio_stream_f(3)
2
3
4
6 al_load_audio_stream_f - Allegro 5 API
7
9 #include <allegro5/allegro_audio.h>
10
11 ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,
12 size_t buffer_count, unsigned int samples)
13
15 Loads an audio file from ALLEGRO_FILE(3) stream as it is needed.
16
17 Unlike regular streams, the one returned by this function need not be
18 fed by the user; the library will automatically read more of the file
19 as it is needed. The stream will contain buffer_count buffers with
20 samples samples.
21
22 The file type is determined by the passed `ident' parameter, which is a
23 file name extension including the leading dot.
24
25 The audio stream will start in the playing state. It should be at‐
26 tached to a voice or mixer to generate any output. See ALLEGRO_AU‐
27 DIO_STREAM(3) for more details.
28
29 Returns the stream on success, NULL on failure. On success the file
30 should be considered owned by the audio stream, and will be closed when
31 the audio stream is destroyed. On failure the file will be closed.
32
33 Note: the allegro_audio library does not support any audio file
34 formats by default. You must use the allegro_acodec addon, or
35 register your own format handler.
36
38 al_load_audio_stream(3), al_register_audio_stream_loader_f(3),
39 al_init_acodec_addon(3)
40
41
42
43Allegro reference manual al_load_audio_stream_f(3)