Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
read_sound_input(3)		 Allegro manual 	     read_sound_input(3)

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  loca-
     tion.  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  in-
     tervals 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 main-
     line  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  un-
     signed 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)

Allegro 			  version 4.4.3 	     read_sound_input(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=read_sound_input&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help