Selector

The Selector audio object allows you to switches between two sets of consecutive input channels and routes one of the sets to the output. While switching between the two sets, it applies ramping.

The Selector object has user configurable number of outputs which would imply that the number of inputs would be twice the output channels. The first n channels would be first group and n+1 to 2n channels would be next group.

For example: If the output configured is 2, then number of inputs would be 4. There would be 2 groups. 1 and 2 channels would form first group; 3 and 4 channels would be next group. The 2 output channels would be routed either from group 1 or group 2 based on selection.

Use case: This object can be deployed whenever a selected input channels are required in output channels in the audio pipeline.

Selector Properties

Below table describes about the Selector audio object properties and functionality.

Properties Description
# of Audio Out Enter the number of output channels.

  • Range: 1 to 127
  • Data type: Unsigned short
  • The default value is set to 1.

The number of inputs are always twice the number of output channels.

Display Name Display the name of the Selector audio object in signal flow design. It can be changed based on the intended usage of the object.

Mode

There are no mode available for Selector audio object.

Additional Parameters

There are no additional parameters available for Selector audio object.

Tuning Parameters

Below table describes the tuning parameters of Selector audio object.

The object exposes one variable for tuning, which is the ramp time.

Parameter Description Type Unit Default Range
Ramp time The selected input channels are available at output channels within ramp time. float ms 1 ms 0 to 10000
Selector Control The object also has tuning parameter SelectorControl for switching between two groups. Unsigned Long None 0 0 – channel 1 to m_NumAudioOut

1 – channel m_NumAudioOut +1 to m_NumAudioIn

Control Interface

The Selector exposes one control, which is the actual switch that triggers switching between the two sets. Below table describes the control parameters of Selector audio object.

Parameter Description Type Unit Default Range
selector Val This is the actual switch that triggers switching between the input groups similar to SelectorControl of tuning parameter. unsigned integer None 0 0 – channel 1 to m_NumAudioOut

1 – channel m_NumAudioOut +1 to m_NumAudioIn

Native Panel

Selector audio object does not support native panel.

Router Panel

Router panel is a dynamic native panel. Panel get adapted in size based on the Router AO configuration.

A screenshot of a computer Description automatically generated with medium confidence

Noise Generator

The Noise Generator audio object generates noise audio samples scaled by a specified gain value.

Use Case: This object can be deployed to generate noise of different types with different gain values.

Noise Generator Properties

Below table describes about the Noise Generator audio object properties and functionality.

Properties Description
# of Audio Out Enter the number of output channels.

  • Range: 1 to 255
  • Data type: Unsigned Short
  • The default value is set to 1.
Display Name Display the name of the Noise Generator audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode Noise generator operates in one of the following two modes.

  • WhiteNoise
  • PinkNoise
  • Pro-Prbs
  • Pro-Lcg

Mode

The Noise generator object supports four different modes of operation.

Mode Description
White Noise (Mode 0) The White noise is generated based on the initial seed value. The initial seed value is multiplied by a scale factor to get white noise. This is the default mode.
Pink Noise (Mode 1) To generate pink noise, white noise is generated first and pink filter is applied over that.
Pro-Prbs (Mode 2) The Pro-Prbs (Pseudo Random Bit Sequence) mode generates white and pink noise that can be chosen through tuning parameter.

  • White Noise Generation: In this mode pseudo random binary sequence generator is used to generate the white noise signal. It is a deterministic algorithm.
  • Pink Noise Generation: In this mode Paul kellet’s algorithm is used to generate pink noise signal.
Pro-Lcg (Mode 3) The Pro-Lcg (Linear Congruential Generator) mode generates white and pink noise that can be chosen through tuning parameter.

  • White Noise Generation: In this mode “Minimal” random number generator of Park and Miller with Bays-Durham shuffle method is used to generate white noise.
  • Pink Noise Generation: In this mode the White Noise that is generated through the linear congruential method is passed through Pink filter 0 and Pink filter 1 to generate the pink noise. The pink noise is passed through the HPF and LPF filters to limit the frequency spectrum to 20 to 20 kHz.

In all the modes, the gain (Noise Level) is in dB scale ranging from -128 dB to 0 dB. The same gain value applies to all channels of the Noise Generator object. It also exposes that same variable for control purposes.

Additional Parameters

There are no additional parameters available for Noise Generator audio object .

Tuning Parameters

Below table describes the tuning parameters of Noise Generator audio object.

For White Noise and Pink Noise mode

Parameter Description Unit Data Type Default Range
Noise Level Generates noise in output channel with gain as tuneable. db Float -60 -128 to 0

For Pro-Prbs and Pro-Lcg modes

Parameter Description Unit Data Type Default Range
Noise Level Generates noise in output channel with gain as tuneable. db Float -100 -128 to 0
Noise Type Generates white or pink noise in output channel with noise type as a tuneable parameter.
This is applicable only for Mode 2 (Pro-Prbs) and Mode 3 (Pro-Lcg).The noise type parameter allows the user to choose white noise or pink noise dynamically.
None Float 1 0 (White)

or

1 (Pink)

Control Interface

The Noise Generator object has one control input – Gain (Noise Level) ranging from -128 dB to 0 dB and this value is applicable to all the channels. This control input is available in all the four modes.

This audio object does not have any control output.

Wave Generator

The Wave Generator audio object generates the sine tone for a given frequency and gain depending on control pins. This audio object has either no input or one input channel. It has one output channel and two control pins.

Use case: The purpose of the Wave Generator audio object is to generate sine waves for a specified frequency and gain in Signal Flow Designer, mostly to test the speakers.

Wave Generator Properties

The table below describes about the Wave Generator audio object properties and functionality.

A screenshot of a computer Description automatically generated

Properties Description
Display Name Display the name of the Wave Generator audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode Wave generator objects operate in one of the following two modes.

  • Sine – Without Input
  • Sine – With Input
  • Sweep

Mode

The Wave Generator object supports three different modes of operation.

Mode Description
Sine – Without Input This mode generates sine wave signal for specified frequency and gain.

This is the default mode.

Sine – With Input This mode generates sine wave signal for specified frequency and gain and mixes the generated signal with input signal. This mode is used for cascading sines.
Sweep This mode generates frequency sweep signal for specified start and end frequency, gain, sweep time, sweep type, and loop type.

Additional Parameters

There are no additional parameters available for the Wave Generator audio object.

Tuning Parameters

The table below describes the tuning parameters of the Wave Generator audio object.

Mode Parameter Description Unit Data Type Range Default
Sine – Without input Bypass The generator is turned ON(0)/OFF(1) None ULong 0 or 1 0
Gain Gain of generated signal dB Float -128 to 0 -128
Frequency Frequency of generated signal Hz Float 0 to half of the sampling frequency 0
Sine – With input Bypass The generator is turned ON(0)/OFF(1) None ULong 0 or 1 0
Gain Gain of generated signal dB Float -128 to 0 -128
Frequency Frequency of generated signal Hz Float 0 to half of the sampling frequency 0.0
Sweep StartFreq Start frequency of sweep signal to be generated Hz Float 10 to half of the sampling frequency 20
EndFreq End frequency of sweep signal to be generated Hz Float 10 to half of the sampling frequency half of the sampling frequency
SweepTime Duration of sweep s Float 0.1 to 20 2
Gain Gain of generated signal dB Float -120 to 20 -20
SweepMethod Type of frequency sweep.

  • LOG (0) method varies the frequency sweep logarithmically.
  • LINEAR (1) method varies the frequency linearly.
None Signed Integer 0 – Logarithmic

1 – Linear

0
LoopType Type of looping/repetition of the signal after “SweepTime”. The loop type can be

  • NONE (0) where the signal is generated once from “StartFreq” to “EndFreq” and stopped.
  • STARTTOEND (1) where the signal is generated and repeated starting from “StartFreq” to “EndFreq”
  • WARBLE (2) where the signal is generated and repeated from “StartFreq” to “EndFreq” and “EndFreq” to “StartFreq” in succession
None Signed Integer 0 – None

1 – START_TO_ END

2 – WARBLE

0

Control Interface

The table below describes the control parameters of the Wave Generator audio object.

Mode Parameter Description Unit Range
Sine – Without input Frequency Frequency of the generated signal Hz 0 to half of the sampling frequency
Gain Gain of the generated signal dB -128 to 0
Active When transition from high to low (Inactive): Completes the signal generation until zero crossover and mute the output and mute input signal for object mode Sine – with input.

When transition from low to high (Active): Reset phase of the signal and signal generation is active and unmute input signal for object mode Sine – with input.

None 0 to 1
Sine – With input Frequency Frequency of generated signal Hz 0 to half of the sampling frequency
Gain Gain of generated signal dB -128 to 0
Active When transition from high to low (Inactive): Completes the signal generation until zero crossover and mute the output and mute input signal for object mode Sine – with input.

When transition from low to high (Active): Reset phase of the signal and signal generation is active and unmute input signal for object mode Sine – with input.

0 to 1

There are no control inputs in ‘Sweep’ mode.

There are no control outputs for this audio object.

Native Panel

Wave Generator object t does not support the native panel.

Limiter

The purpose of Limiter audio object is to control the output level of the audio.

This AO supports in-place computation based on the core type.

Use Case: The Limiter AO can be used wherever there is a necessity to limit the signal level to be below a safe threshold level. A typical example is to protect speakers from unsafe signal levels.

Limiter Properties

Below table describes about the Limiter audio object properties and functionality.

Properties Description
# of Channels The number of audio channels it can process is configurable in the SFD and each channel has its own set of specifications.

  • Range: 1 to 250
  • Data type: Signed Short
  • The default value is set to 1.
Display Name Display name of the Limiter audio object in signal flow design. It can be changed based on the intended usage of the object.

Mode

The Limiter audio object supports following three modes:

  • No Control: No option for changing threshold value through control input. This is the default mode.
  • One Set: One control input whose value is applied to change the threshold of all the channels
  • Multi Set: Individual control input for each channel to change the threshold. If the number of channels exceeds 1, the control inputs are grouped as one block control input.

Additional Parameters

Parameter Description
Max Lookahead Max Lookahead value is used to define the maximum lookahead time. During tuning from GTT, you can vary the lookahead time from 0 to the value set in the additional parameter.

The memory requirement largely depends on the lookahead time, and this feature helps you to define their optimal maximum lookahead time based on the memory availability.

This can be configured during design time.

  • Range: 0 to 0.15 seconds
  • Data type: Float
  • The default value is set to 0.0015.

Size of the lookahead delay buffer (in float words) = round (sampleRate * Max Lookahead)

For a sample rate of 48000 and maximum lookahead of 0.15 s, the required buffer size is 7200 float Words. Hence this variable is made configurable to enable the user to choose optimal maximum lookahead value based on the available memory.

A screenshot of a computer Description automatically generated
Threshold Type This additional variable is used only in One Set and Multi Set modes.

Under this modes, the AO will be having control input(s) and through this additional variable the user configures whether to use the control input value as absolute threshold or offset threshold.

This option can be configured during design time.

  • Range: 0 to 1
    • 0 = Offset Threshold; the control input value would be applied on top of the tuning threshold value.
    • 1 = Absolute Threshold; the tuning threshold value would be ignored, and the control input value would be applied.
  • Data type: Char

The default value is 0.

Attack Phase

The Limiter operates in two modes during the attack phase when the input signal level is higher than the desired threshold.

  • Fixed attenuation of 10 dB within the given attack time if the difference between the input signal level and the threshold is much higher. This phase is used initially to bring down the Limiter output quickly closer to the threshold.
  • Adaptive attenuation if the threshold is slightly lower than the input signal level. This is deployed towards the end of attack phase for fine tuning the output level to match the threshold.

Hence if the threshold is less than the input signal by less than or equal to 10 dB, then within the given attack time the Limiter output is restricted to the threshold level ± 1 dB.

If the threshold is much lower than the input signal level (say 30 dB), the difference is first brought down to less than 20 dB within the attack time; the difference is further reduced to less than 10 dB within twice the attack time; finally, the output matches the threshold ± 5% within thrice the attack time.

Release Phase

The release time is the time taken by the Limiter output to follow the input signal level from the time the input signal level drops below the threshold. During this phase, the Limiter output follows exponential (time constant) growth to reach the input level.

Accordingly, the output level will be as given below during this phase (If the release time is denoted as R, and the difference between the output level at the start of release phase and the input signal level is P dB):

  • After R sec: 63% of P dB
  • After 2R sec: 86% of P dB
  • After 3R sec: 95% of P dB

Tuning Parameters

The tuning parameters are limited to safe range such that Limiter audio object shall not produces NaNs. In GTT, the limiter exposes the following parameters for each channel of the limiter:

Parameters Description Type Range Default
Gain Controls the upper bound of gain that the limiter applies on weak signals. Float 0 to 30 0 dB
Threshold Controls where the limiter begins to activate. Float -30 to 0 0 dB
Attack Time Controls the limiter’s attack time for each channel. Float 0.1 to 20 1 ms
Release Time Controls the limiter’s release/hold time for each channel. Float 1 to 2000 150 ms
Hold Time Controls the hold counter. Float 0 to 10 10 ms
Hold Threshold Controls where the limiter enters hold or release. Float -1 to 0 0 dB
Look Ahead Time Look Ahead buffer for controlling the overshoots. Float 0 to Max Lookahead 0.0015 s
Bypass Flag to bypass the Limiter operation for the particular channel. Unsigned Long 0 to 1

0 – Bypass Disable

1 – Bypass Enable

0

State Parameters

Parameters Description Type Unit Range Default
Attenuation The attenuation value for each channel indicates the amount of the gain reduction (attenuation) applied when the Limiter is active.

This value will not be updated while the limiter is in the ‘Bypass’ state.

Float dB 0 to 60 0 dB
Effective Threshold
Indicates the actual threshold value applied – for each channel. Float dB -60 to 0 0 dB

When the control input of the Limiter AO is configured as Absolute Threshold, the last applied setting will be used internally, which means the tuning parameter change will overwrite the control input and vice versa.

Control Interface

The Control audio object does not have any control output in any modes. However, the AO has control input(s) in One Set and Multi Set modes.

  • In One Set mode, the object has one control input whose value is applicable for all channels.
  • In Multi Set mode, the number of control inputs is same as the number of channels – each channel having a dedicated control input. These control inputs in Multi Set mode are grouped as one Block Control input when the number of control inputs exceeds 1.

For further info on the Limiter audio object and its functional behaviour, please also refer to Limiter User Guide Supplement.

Delay

The purpose of the Delay audio object is to time shift between the input and output audio samples. The audio object has the ability to add delays to several channels, each with a different delay setting.

A diagram of a flowchart Description automatically generated with low confidence

However, each channel will support the maximum allowed delay set in SFD. As a result, each channel will have a buffer that is the appropriate size to handle the maximum delay. The Delay audio object can be used when a time delay is required in an audio pipeline. The objects support DelayPool functionality as an operating mode. In this mode, the sum of the individual channel delay configured will be less than or equal to the maximum delay.

Use Case: The Delay audio object can be used when a time delay is required in an audio pipeline.

Delay Object Properties

Below table describes the Delay audio object properties and functionality.

Properties Description
# of Channels The number of channels is configurable in the SFD and is always equal to both, the number of input and output channels.

  • Range: 1 to 255
  • Data type: uint

The default value is set to 1.

Max.delay(ms) Specifies the maximum possible delay for each channel in the audio object. For Delay Pool  (Refer below on mode details) mode Max Delay is the maximum delay that can be utilized by all channels combined.

  • Range: 1 to 9999 ms
  • Data type: uint

The default value is set to 1.

Max delay value specified in milliseconds (ms).

Display Name Display the name of the Delay audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode Delay object operates in one of the following three modes.

  • Instant
  • CrossFade
  • DelayPool

m_Mode is used to specify whether the change in the delay is Instant or uses a Crossfade or operates as DelayPool.

Additional Parameters
Delay object has three additional parameters.

  • Crossfading Duration in ms
  • Configuration Control Input(s)

Object Mode

Delay object operates in one of the following three modes.

Parameter Description Value Data Type
Instant No fading – change straight to the newly requested delay value. This is the default mode. 0 (Instant) uint
CrossFade To avoid audio discontinuity when the delay value changes. 1 (Crossfade) uint
DelayPool Max Delay determines the total DelayPool size which is common for all the channels. When the delay of the individual channel is configured, the sum of delay values (of all the channels) can not exceed Max Delay. Changes in delay values are accepted by the audio object only when the sum does not exceed the Max Delay.

It does not support fading and no control inputs are added in this mode.

When the sum of delay values exceeds the Max Delay and preset is applied in parameter sets of GTT, then the UI may group some delay changes into one xTP command. This may cause audio objects to accept some delay value changes and reject other delay value changes.
This accept/reject can happen because the audio object checks to see if the sum exceeds Max Delay on receiving xtp command.
The audio object would accept the delay values when the sum returns back to the acceptable limit (sum <= Max delay).

2 (DelayPool) uint

Additional Parameters

Parameter Description
Crossfading Duration in ms Fade time, only effective when the delay is operating in Crossfade mode.

  • Range: 1 to 1000
  • Data type: Float
  • The default value is set to 50.
Configuration Control Input(s) Configuration control inputs (Enable/Disable).

  • If set to 0 – Disables control inputs.
  • If set to 1 – Enables one control input to configure the delay value for all channels.
  • If set to 2 – Enables one control input per channel for individual configuration.
A screenshot of a computer Description automatically generated

Tuning Parameters

Parameter Details Default Value Range Data type
Delay Delay to be applied across each channel 0 (sec) 0 – Max.delay (sec) Float

Control Interface

Parameter Details Default Value Range Data type
Delay(OneSet) One control input is added to set the delay value for all audio channel to the same configured value. 0 (sec) 0 – Max.delay (sec) Float
Delay(MultiSet) One control input per channel is added to set the delay for individual channel. 0 (sec) 0 – Max.delay (sec) Float

Native Panel

The Delay panel associated with the Delay audio object is used to change the signal delay for each channel. For more details, refer to the Delay Panel

A screenshot of a computer Description automatically generated with medium confidence

Gain

The purpose of the Gain audio object is to provide amplitude scaling of the signal for each channel. The gain object also supports the invert and mute features.

Use Case: This object is deployed whenever a gain is required in the audio pipeline.

Gain Object Properties

Details about the Gain audio object properties and functionality.

Properties Descriptions
# of Channels In the Signal Flow Designer (SFD), you can specify the maximum possible gain for the audio object. The number of channels is configurable in the SFD and is always equal to both the number of input and output channels.

  • Range: 1 to 225
  • Data type: uint
  • The default value is set to 1.
Display Name Display the name of the gain audio object in the signal flow design. It can be changed based on the intended usage of the object.
Object Mode There are no modes available for Gain audio objects.
Additional Parameters There are no additional parameters available for the Gain audio object.

Tuning Parameters

The gain audio object supports in-place computation based on the core type.

The following are the parameters you can tune in to GTT.

Parameter Description Unit Range
Gain Applied to the input channel. dB -128 to 20
Invert
  • If set to 1, the input value is multiplied by -1.
  • If set to 0, the input value is multiplied by 1.
None 0 or 1
Mute
  • If set to 1, the output is muted.
  • If set to 0, the output is not muted.
None 0 or 1

Control Interface

There are no control parameters available for the Gain audio object.

Native Panel

The Gain panel lets you adjust the signal gain for each channel of the Gain audio object. For more details, refer Gain Panel.

Level Monitor

The Level Monitor is intended to measure the level of input; the audio samples are sent to the output without modification.

Use case: This object can be deployed in Level Monitor mode whenever there is a need to measure the level of signal level and in Clip Meter mode to check if the level is causing clipping. The same input is sent as output without modification.

Level Monitor Properties

Below table describes the Level Monitor audio object properties and functionality.

Properties Descriptions
# of Channels In the Signal Flow Designer (SFD), the number of control outputs is equal to the number of audio channels. Each control output writes out the channel level/clip indication value based on the MODE selected.

  • Range: 1 to 254
  • Data type: Signed Short
  • The default value is set to 1.
Display Name Display the name of the Level Monitor audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode During design time, the audio object channel can be configured in one of the two operation modes.

  • Level Monitor
  • Clip Meter
Additional Parameters There are no additional parameters available for the Level Monitor audio object.

Mode

During design time, the audio object can be configured in one of the two operation modes.

  • Level Monitor
  • Clip Meter

Mode Description
Level Monitor In this mode, the signal level is measured and the value is sent to the control output.
This is the default mode.
Clip Meter In this mode, the object computes the signal level and compares it with the threshold set through the tuning parameters. A flag is set/reset if the signal level is above/below the threshold and this flag is sent to the control output.

Tuning Parameters

Under Level Monitor and Clip Meter mode, the following are the tuning parameters available for each channel.

Mode Parameter Description Range Default Data Type Unit
Level Monitor

LEV_MODE To select the method of computation of the input signal level

  • RMS: It is the RMS value of the input signal
  • Linear: It is the average of the input signal
  • Peak: It is the peak/max sample value

In all the above types, the computed level is always presented in dB (logarithmic scale)

0 – RMS

1 – LINEAR

2 – PEAK

0 Float NA
DB_LEAK_PER_SEC Amount of dB drop per second in Peak Level mode. 1 to 60 30 Float dB
PEAK_HOLD_TIME Amount of time peak is held. 0 to 1 0.05 Float second
Clip Meter Threshold The threshold value for the channel to treat a signal as being clipped. -20 to 20 -0.25 Float dB

State Parameters

Under Level Monitor and Clip Meter mode, the following is the state parameter available for each channel.

Mode Parameter Description Range Default Data Type Unit
Level Monitor LEVEL_VALUE Measured signal level for the channel -128 to 20 0 Float dB
Clip Meter Clip Indicator Clip Indicator for the channel based on the tuned threshold parameter 0 or 1 0 Unsigned Long None

Control Interface

Under Level Monitor and Clip Meter mode, the following is the control output available for each channel.

Mode Parameter Description Range Data Type Unit
Level Monitor Signal Level Measured signal level for the channel -128 to 20 Float dB
Clip Meter Clip Indicator Clip Indicator per channel based on the tuned threshold parameter 0 or 1 Float None

Native Panel

The Level Monitor has native panel and can be used to visualize measurements and to tune measurement parameters, like types of level values. Panel shows as many channels as it is specified in SFD. For more details, refer to Level Monitor Panel.

FaderBalance

The primary purpose of the Fader Balancer audio object is to optimize the audio quality within the vehicle’s cabin by adjusting the sound distribution. This audio object allows to identify the “sweet spot” of the sound by moving in the x and y directions.

The Fader Balance object has only one operating mode and has three additional configuration parameters – Speaker Groups, Number of Steps, and Block Control. Using these additional parameters, you can configure the setup during design time.

Each audio channel may belong to one or two speaker groups as set in the additional variable.

Fader speaker group has the following speaker types:

  • CENTER
  • SIDE
  • BASS
  • FRONT
  • REAR
Balance speaker group has the following speaker types:

  • CENTER
  • LEFT
  • RIGHT

Each speaker type in each speaker group has its own gain table.

The output samples are generated by multiplying the input samples with the composite gain value that is a product of the gain levels of the Balance and Fader gain tables assigned to this channel and as pointed by the control inputs – Control_Balance and Control_Fader. The composite gain value is morphed to avoid pops.

Channel configuration (assignment to speaker types of the selected speaker groups), morphing time, and the gain level of each step are configurable through the xTP interface. Basically, mixing run-time tuning (add cfg params) and design-time tuning (add cfg params). GTT is used for configuration in general, and xTP is the protocol used to deliver tuning data.

Fader and Balance positions are provided through control inputs.

Fader Balance is ported from the Summit version with the following differences:

  • The option for 4 modes is not supported. This shall be handled with the preset files. The number of control inputs is brought down to 2 due to this change.
  • Stand-alone Fader AO and Balance AO can be achieved by configuring the additional parameters in the SFD.
  • The step count is made as an additional variable instead of using the “Number of Elements” field.
  • The channel configuration is done using a drop-down menu to select only one speaker type in each speaker group. This prevents the selection of multiple speaker types by mistake.

Use Case: Using this method, you can optimize the sound loudness on the left or back of the cabin.

Fader Balance Properties

Below table describes the Fader Balance audio object properties and functionality.

Properties Descriptions
# of Channels The number of audio channels it can process is configurable in the SFD and ranges from 1 to 255. The number of audio inputs is always equal to the number of audio outputs.

  • Range: 1 to 225
  • The default number of channels is set to 8.
Display Name Display the name of the Fader Balance audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode There are no mode available for Fader Balancer.
Additional Parameters Fader Balancer object has three additional parameters.

  • Speaker Groups
  • Number of Steps
  • Block Control

Additional Parameters

Parameters Description
Speaker Groups Speaker Groups can be set to one of the following three options:

  • Fader and Balance speakers (0) – Default
  • Balance speakers only (1)
  • Fader speakers only (2)
Number of Steps The “Number of Steps” is a common variable that controls the number of gain levels that the user can operate.

To control the gain level of fader and balance speakers the value shall be odd, and this value is common for balance and fader speaker groups. The number of steps needs to be an odd number and shall range from 3 to 65 with the default value at 31.

The xAF data order is set as “xAF_ODD” to communicate to the GTT through DDF to prevent entering even numbers by the user.

Block Control Block Control Disabled (0) – Default

Block Control Enabled (1)

Tuning Parameters

The following tuning parameters are available for the Fader Balancer audio object.

Parameter Name Description Type Unit Default value
MorphingTime Morphing time. The range is from 0 ms (no morphing) to 100 ms.

Morphing time follows time constant and the morphing time is denoted as M. Following is the percentage of change achieved:
 – After M: 63%
– After 2M: 86%
 – After 3M: 95%
 – After 4M: 98%
 – After 5M: 99%
Hence the morphing time can be configured accordingly.

float ms 0.01
Channel # Assignment This parameter assigns a particular audio channel to one or none of the speaker types in each group. The following pair of speaker-type assignments is available for each channel.

  • Balance Speaker Types: CENTER, LEFT, RIGHT and None
  • Fader Speaker Types: CENTER, SIDE, BASS, FRONT, REAR and None
ULong

ULong

BAL_CENTER

FAD_CENTER

BalanceCenterTable Balance table for center speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0
BalanceLeftTable Balance table for left speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0 dB for the first (NUMBER_OF_STEPS+1)/2 steps, next are linearly decreased with equal step in dB scale to -128 dB.
BalanceRightTable Balance table for right speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB Start from -128 dB and are linearly increased with equal step in dB scale to 0dB to (NUMBER_OF_STEPS-1)/2 step, next their value is 0 dB.
FaderCenterTable Fader table for center speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0
FaderSideTable Fader table for side speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0
FaderBassTable Fader table for bass speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0
FaderFrontTable Fader table for front speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB 0 dB for the first (NUMBER_OF_STEPS+1)/2 steps, next are linearly decreased with equal step in dB scale to -128 dB.
FaderRearTable Fader table for rear speaker group. The gain value for each step is tunable.

Range: -128 to 0 dB

float dB Start from -128 dB and are linearly increased with equal steps in dB scale to 0dB to (NUMBER_OF_STEPS-1)/2 step, next their value is 0 dB.

Control Interface

The following two control input parameters are available for the audio object based on additional configuration parameter “Speaker Groups”.

  • Balance – To set the Balance knob position
  • Fader – To set the Fader knob position

When block control is enabled,  Fader and Balance control signals are grouped into one control pin.

Native Panel

The Fader Balance audio object allows to identify the “sweet spot” of the sound by moving in the x and y directions. Using this method, you can optimize the sound loudness on the left or back of the cabin. For more details, refer Fader Balance Native Panel.
A screenshot of a computer Description automatically generated