start_sound_input(3alleg4) [linux man page]

start_sound_input(3alleg4)					  Allegro manual					start_sound_input(3alleg4)

NAME

       start_sound_input - Starts recording in the specified format. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int start_sound_input(int rate, int bits, int stereo);

DESCRIPTION

       Starts recording in the specified format, suspending audio playback as necessary if the card is not full duplex.

RETURN VALUE

       Returns the buffer size in bytes if successful, or zero on error.

SEE ALSO

       install_sound_input(3alleg4),		read_sound_input(3alleg4),	      stop_sound_input(3alleg4),	   digi_recorder(3alleg4),
       set_sound_input_source(3alleg4), get_sound_input_cap_parm(3alleg4),  get_sound_input_cap_bits(3alleg4),	get_sound_input_cap_rate(3alleg4),
       get_sound_input_cap_stereo(3alleg4)

Allegro 							   version 4.4.2					start_sound_input(3alleg4)

read_sound_input(3alleg4)					  Allegro manual					 read_sound_input(3alleg4)

NAME

       read_sound_input - 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(3alleg4)

Allegro 							   version 4.4.2					 read_sound_input(3alleg4)