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

FreeBSD Manual Pages

  
 
  

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

NAME
       reserve_voices  -  Reserve  a number of voices for the digital and MIDI
       drivers.	Allegro	game programming library.

SYNOPSIS
       #include	<allegro.h>

       void reserve_voices(int digi_voices, int	midi_voices);

DESCRIPTION
       Call this function to specify the number	of voices that are to be  used
       by  the	digital	and MIDI sound drivers respectively. This must be done
       _before_	calling	install_sound(). If you	reserve	too many voices,  sub-
       sequent	calls to install_sound() will fail. How	many voices are	avail-
       able depends on the driver, and in some cases  you  will	 actually  get
       more  than  you reserve (eg. the	FM synth drivers will always provide 9
       voices on an OPL2 and 18	on an OPL3, and	the  SB	 digital  driver  will
       round  the number of voices up to the nearest power of two). Pass nega-
       tive values to restore the default settings. You	should be  aware  that
       the  sound  quality is usually inversely	related	to how many voices you
       use, so don't reserve any more than you really need.

SEE ALSO
       set_volume_per_voice(3),	install_sound(3),  detect_digi_driver(3),  de-
       tect_midi_driver(3), get_mixer_voices(3)

Allegro				 version 4.4.3		     reserve_voices(3)

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

home | help