This version (11 May 2021 10:19) was approved by Krithika Manchale.

Click here to return to the Basic page

Surround Sound Volume Control


The Surround Sound Volume Control block enables positioning of source elements relative to a listener head. The default block has one source centered in front of the listener. Right-click the block border or title to grow the algorithm up to 6 sources. Sources and head can be dragged to any position in the room, or set more precisely via the Set Positions and Room Dimensions form (right-click the center of the block). Its parameters include:

  • Units -- English (US) or Metric
  • Coordinate System -- Cartesian or Polar
  • Width and length of the room
  • Head location
  • Source locations

Press Resize to accept changes. Grayed-out source locations mean the source is not currently added.

Targets Supported

Name ADSP-214xx ADSP-215xx/SC5xx ADAU145x/146x
———————————————————— ——————-- ——————————-- —————————-
Surround Sound Volume Control NA B NA



Input XAudioInput channel X


Output XAudioOutput channel X


  • X - Channel Index

Configurable Parameters

GUI Parameter NameDefault ValueRangeFunction Description
HeadGain -32dB 0 to -32dB Scales the input signal by the specified gain
Units US-Feet US-Feet, Metric Switches between the units
CoordinateSystem Cartesian Cartesian, Polar Switches between the coordinate systems
HeadLocationX 0 Depends on coordinate system, units X-Coordinate of the head knob on the chart
HeadLocationY 0 Depends on coordinate system, units Y-Coordinate of the head knob on the chart
SourceLocationX -0.88 Depends on coordinate system, units X-Coordinates of the output speakers on the chart
SourceLocationY 0.88 Depends on coordinate system, units Y-Coordinates of the output speakers on the chart
RoomLength 5 0.01 - 30 Length of the room(chart length on the module)
RoomWidth 5 0.01 - 30 Width of the room(chart width on the module)
NumChannels16Number of input and output channels. Change in this value requires re-compilation

DSP Parameters

Parameter Name Description ADSP-214xx/SC5xx/215xx ADAU145x/146x
—————————————- ——————————————————————————-- —————————————- —————————-
GainScales the input signal by the specified gainFloat NA

DSP Parameter Computation

distance= Math.Sqrt(Math.Pow(sourceX - _headLocationX, 2) + Math.Pow(sourceY - _headLocationY, 2));
headXCart = _headLocationX * Math.Sin(_headLocationY);
headYCart = _headLocationX * Math.Cos(_headLocationY);

sourceXCart = sourceX * Math.Sin(sourceY);
sourceYCart = sourceX * Math.Cos(sourceY);

distance = Math.Sqrt(Math.Pow(sourceXCart - headXCart, 2) + Math.Pow(sourceYCart - headYCart, 2));

if (distance ⇐ 2) then, computedGain = _globalGain + 6 - 10 * Math.Log10((distance + 2) / 2);
if (distance > 2) then, computedGain = _globalGain + 8.989 - 20 * Math.Log10((distance + 2) / 2);

Gain(Linear) = 10^(Gain(dB)/20)

resources/tools-software/sigmastudiov2/modules/gain/surroundsoundvol.txt · Last modified: 07 May 2021 07:20 by Nikhin Shetty