From cd0b3ce0c574def695f8c9168657e32e29dd2b39 Mon Sep 17 00:00:00 2001 From: derselbst Date: Thu, 21 Apr 2022 13:22:24 +0200 Subject: [PATCH] Amend documentation of audio.coreaudio.channel-map --- doc/fluidsettings.xml | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/doc/fluidsettings.xml b/doc/fluidsettings.xml index 201a6d45..889620c8 100644 --- a/doc/fluidsettings.xml +++ b/doc/fluidsettings.xml @@ -457,24 +457,25 @@ Developers: str (empty string) - This setting is a comma-separated integer list that maps CoreAudio channels - to output device channels. The value of each position in the list, up to the number of - output channels available on your device, is the zero-based index of the fluidsynth - output channel to route there. Additionally, the special value of -1 will turn off - an output. - + This setting is a comma-separated integer list that maps fluidsynth mono-channels + to CoreAudio device output channels. Each position in the list represents the output channel + of the CoreAudio device. + The value of each position indicates the zero-based index of the fluidsynth + output mono-channel to route there (i.e. the buffer index used for fluid_synth_process()). + Additionally, the special value of -1 will turn off an output. +

For example, the default map for a single stereo output is "0,1". A value of "0,0" will copy the left channel to the right, a value of "1,0" will flip left and right, and a value of "-1,1" will play only the right channel. - +

With a six-channel output device, and the synth.audio-channels and synth.audio-groups settings both set to "2", a channel map of "-1,-1,0,1,2,3" will result in notes from odd MIDI channels (audible on the first stereo channel, i.e. mono-indices 0,1) being sent to outputs 3 and 4, and even MIDI channels (audible on the second stereo channel, i.e. mono-indices 2,3) being sent to outputs 5 and 6. - - If the list specifies fewer than the number of available outputs channels, outputs - beyond those specified will maintain the default channel mapping. +

+ If the list specifies less than the number of available outputs channels, outputs + beyond those specified will maintain the default channel mapping given by the CoreAudio driver.