FreeBSD Manual Pages
al_set_sam...nnel_matrix(3) Library Functions Manual al_set_sam...nnel_matrix(3) NAME al_set_sample_instance_channel_matrix - Allegro 5 API SYNOPSIS #include <allegro5/allegro_audio.h> bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix) DESCRIPTION Set the matrix used to mix the channels coming from this instance into the mixer it is attached to. Normally Allegro derives the values of this ma- trix from the gain and pan settings, as well as the channel configurations of this instance and the mixer it is attached to, but this allows you over- ride that default value. Note that if you do set gain or pan of this in- stance or the mixer it is attached to, you'll need to call this function again. The matrix has mixer channel rows and sample channel columns, and is row major. For example, if you have a stereo sample instance and want to mix it to a 5.1 mixer you could use this code: float matrix[] = { 0.5, 0.0, /* Half left to front left */ 0.0, 0.5, /* Half right to front right */ 0.5, 0.0, /* Half left to rear left */ 0.0, 0.5, /* Half right to rear right */ 0.1, 0.1, /* Mix left and right for center */ 0.1, 0.1, /* Mix left and right for center */ }; al_set_sample_instance_channel_matrix(instance, matrix); Returns true on success, false on failure (e.g. if this is not attached to a mixer). SINCE 5.2.3 [Unstable API]: New API. Allegro reference manual al_set_sam...nnel_matrix(3)
NAME | SYNOPSIS | DESCRIPTION | SINCE
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_set_sample_instance_channel_matrix&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>
