read_sound_input - Man Page

Retrieves the last recorded audio buffer. Allegro game programming library.

Synopsis

#include <allegro.h>

int read_sound_input(void *buffer);

Description

Retrieves the most recently recorded audio buffer into the specified  location. The buffer size can be obtained by checking the return value from start_sound_input(). You must be sure to call this function at regular intervals during the recording (typically around 100  times a second), or some data will be lost. If you are unable to do this  often enough from the mainline code, use the digi_recorder() callback to  store the waveform into a larger buffer of your own.

Note: many cards produce a click or popping sound when switching between record and playback modes, so it is often a good idea to discard the first buffer after you start a recording. The waveform is always stored in unsigned format, with stereo data consisting of alternate left/right samples.

Return Value

The function will return non-zero if a buffer has been copied or zero if no new data is yet available (you were too fast checking the input).

See Also

start_sound_input(3)

Referenced By

start_sound_input(3).

version 4.4.3 Allegro manual