read_sound_input
Retrieves the last recorded audio 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.
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).
Related Discussions
The following threads each have code containing this keyword:
Note: You can click on the numbers to jump directly to the posts that reference this page.
Related Projects
The following projects include source code containing this keyword: