The AudioToControl audio object receives audio data, it calculates the envelope based on the mode of operation (either RMS or Peak) and forwards them onto control outputs.
This object accepts N number of input audio signals and calculates the envelope and sends them into corresponding control outputs.

Below are the features of AudioToControl audio object.

• The control outputs / state values are in linear scale.
• The AO supports all sample rates and blocklengths supported by xAF. The AO only reads the audio samples for calculating RMS or peak values. The AO supports in-place computation.

AudioToControl Properties

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

Properties	Description
# of Channels	Enter the number of channels. The number of control outputs are equal to number of channels. This audio object operates in RMS and Peak modes. Range: 1 to 254 By default, the number of channels is set to 1.
Display Name	Display name of the AudioToControl audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode	This audio object works in two modes. RMS Peak

Mode

• RMS: The RMS value of input audio channels are calculated and sent out in corresponding control out channel.
• Peak: The Peak value of input audio channels are calculated and sent out in corresponding control out channel.

Additional Parameters

There are no additional parameters available for AudioToControl audio object.

Tuning Parameters

It has tunable parameters attack and release time.  Attack and release time are common for all channels.

Parameter	Data Format	Memory Offset	Unit	Range	Default Value
Attack time	float	0	Msec	0 to 1000	100
Release time	Float	4	Msec	0 to 1000	10

The AudioToControl audio object has state parameters envelope value for all channels, rate attack and rate release. The states are read-only.

Parameter	Data Format	Memory Offset	Unit	Range	Default Value
Channel 1 envelope	Float	0	None	– 9999 to 9999	None
Channel 2 envelope	Float	4	None	– 9999 to 9999	None
Channel N envelope	Float	(N – 1) * 4	None	– 9999 to 9999	None

Control Interface

There are no control inputs. The number of control outputs is always equal to the number of audio inputs.

Native Panel

AudioToControl audio object does not support native panel.

The Lookup Table (LUT) audio object performs a table lookup to create a relationship between a control input and a control output.

For example, the LUT converts the vehicle speed values to gain by manipulating the speed values using a look up table. The LUT module gives out values of multiple 1-D functions (i.e. control outputs) at specific query points using ‘linear’ or ‘nearest index’ or ‘lower index’ or ‘exact match’ Lookup Method.

The number of columns in the LUT is configurable by modifying the number of elements from the SFD. The first column of the table contains one independent vector, which corresponds to the x-axis of the interpolation. Each of the corresponding columns corresponds to the interpolation slopes for the outputs. The number of rows of LUT denotes the number of steps in the interpolation of each control output.

The LUT also supports multiple control inputs. This enables LUT to send table values on different set of outputs independently using the same LUT table. This eliminates the need for duplication of LUT objects when the user wants to send table values to different audio objects independently using same table.

The LUT performs the Lookup method (floor, round, linear interpolation, exact match) between values.

• If the control input is below the minimum value in the x-axis and the lookup method is linear interpolation / lower index / nearest index — then the LUT will output the minimum value in the table. If the lookup method is an exact match, then there will be no output.
• If the control output is above the maximum value in the x-axis and the lookup method is linear interpolation / lower index / nearest index — then the LUT will output the maximum value in the table. If the lookup method is an exact match, then there will be no output.

In addition, LUT supports Axis Linearity and, when enabled, LUT optimizes interpolation and assumes equally spaced steps of interpolation, i.e x-axis interpolation.

• If the ‘Linear Interpolation’ (LookUp Method = 1) is selected and the control input has a value between two rows — then it is manipulated to create the control output vector.
• If the ‘Lower Index’ (LookUp Method = 2) is selected and the control input has a value between two rows — then the control output is the previous known control output, which is the (nearest) lower index. This follows for the other control inputs.
• If the ‘Nearest Index’ (LookUp Method = 3) is selected and the control input has a value between two rows — then the control output is the nearest index (rounded value index). This follows for the other control inputs.
• If the ‘Exact Match’ (LookUp Method = 4) is selected — the object will output only when the control input matches the axis, or else there will be no output.

LUT Axis linearity is to be used with linearly spaced axis values.

Every time the LUT receives an input on its control pin, it will output the table values on the control pin outputs (Number of Control Outputs = Number of Control Inputs * Number of Elements and cannot be more than 100 / Number of Elements. Values beyond the limit will result in clamping of the number of control inputs to the maximum allowed control inputs).

Currently, the LUT is a series of dimensional tables of resolutions from 1 to 200.
The number of elements corresponds to the number of columns. The table resolution on columns is configurable by modifying the first additional variable ‘Table Height’. Both the dependent and independent table values are configurable in the GTT. The x-axis (control-input) needs to be in ascending order and is configurable through the tuning tool.

Related Topics

• Create LUT Object
• Create LUT Object in Mode 0 (LUT 2D)
• Create LUT Object in Mode 1 (LUT Index)

Lookup Table Properties

The table below describes the Lookup Table (LUT) audio object properties and functionality.

Properties	Description
Number of elements	Enter the number of channels. Range: 1 to 254 The default is set to 1.
Display Name	Display the name of the LUT audio object in the signal flow design. It can be changed based on the intended usage of the object.
Object Mode	LUT works in two modes. LUT 2d LUT Index
Additional Parameters	LUT has following additional parameters: Table Height Number of Control Inputs LUT Axis Linearity LUT Depth Lookup Method Block Control Group

Mode

LUT audio object is used to manipulate some control input to pass to one or multiple connected objects. The object operates in two modes.

Mode	Description
LUT 2d	In the 2D mode, the number of control inputs is configurable, and the number of outputs varies based on the number of elements and the number of control inputs selected. In this mode, only one LUT table is allowed. The objective of this LUT mode is to take in a control input, such as vehicle speed, and interpolate an output value, such as gain, based on values set during tuning. The output is then sent as input to other audio blocks. Primary Success Scenario The user will tune the object and initialize from GTT. Capture input parameter. Perform a lookup operation to determine the output based on the selected lookup method. Output to the next object in the signal flow.
LUT Index	In the Index mode, along with the control inputs, there is a control input. This control input selects which ‘set’ of tables to use. Otherwise, the modes behave the same. The number of sets is configured by the additional variable ‘LUT Depth’. The maximum depth is 8. In this mode, up to 8 LUT tables are allowed and can be configured in the additional config “LUT Depth”. The objective of this mode of LUT operation is to determine the output given an indexed set of tables. Primary Success Scenario The user will tune the object and initialize from GTT. Capture input parameters. Determine which indexed table to use. Perform a lookup operation to determine the output based on the selected lookup method. Output to the next object in the signal flow.

Additional Parameters

The following are additional parameters you can configure:

• Table Height
• Number of Control Inputs
• LUT Axis Linearity
• LUT Depth
• Lookup Method
• Block Control
• Group

Parameter	Description
Table Height	This parameter corresponds to the size of each table in linear steps, which can be configured through an additional configuration variable. The default height of each table in linear steps is 2. The minimum height of each table in linear steps is 1. The maximum height of each table in linear steps is 200.
Number of Control Inputs	This parameter is used to configure the number of control inputs. The minimum number of control inputs is 1. The maximum range of control inputs is dependent on the number of elements and should not exceed (100 / Number of Elements). Values beyond the limit will result in clamping of the number of control inputs to the maximum allowed control inputs. This enables LUT to send table values to different set of outputs independently using the same LUT table. This eliminates the need for duplication of LUT objects when the user wants to send table values to different audio objects independently using same table.
LUT Axis Linearity	This parameter is used to set the manipulation logic for interpolation through an additional configuration variable. Manipulation logic 0: The Input axis may be unevenly spaced. This allows the user to specify table resolution where needed, but requires greater effort by the object, resulting in slower execution time. 1: The Object assumes evenly spaced values on the input axis in order to speed operations. The default value of LUT Axis Linearity is 0.
LUT Depth	This parameter is used to determine the depth of the table, which can be configured through an additional configuration variable. The default depth of each table in linear steps is 1. The minimum depth of each table in linear steps is 1. The maximum depth of each table in linear steps is 8.
Lookup Method	This parameter supports one additional configuration of Lookup Method (linear interpolation/floored index/rounded index) for values on the output axis. This decides how output is computed for an input value that is between two given input axis values. Lookup Method = 1 (Linear interpolation): It provides standard linear interpolation of output between two axis points. This is the default type. Lookup Method = 2 (Lower Index): This is a Zero-hold or “previous” type of interpolation. It gives the nearest lower index, which is the floor value index. For a given input, the control output is the value of the output that corresponds to the most previous input. Lookup Method = 3 (Nearest Index): This gives the nearest index, which is the rounded value index. Lookup Method = 4 (Exact Match): This outputs the row values only when the input exactly matches the axis.
Block Control	This parameter supports additional configuration of Block Control, which can be enabled or disabled by selecting between Block Control Disabled (default) and Block Control Enabled. If it is enabled, the control outputs are grouped into groups of the number of elements, and the number of outputs will then be equal to the number of control inputs.
Group	The Group feature allows organizing the LUT audio objects into different groups. When the native panel of any LUT audio object is opened, all the LUT audio objects with the same group name are displayed in that native panel. If no LUT objects are assigned to any group, the native panel displays all the LUT audio objects.

Tuning Parameters

The total number of tuning parameters depends on the LUT table height, table depth and number of elements. The number of elements is equal to the number of LUT table columns.

In the LUT table, there is also an additional column for ‘LUT Index’ mode, which stores the values of x-axis interpolation points. As a result, the total number of elements in the LUT’s parameter memory is as follows.

Parameter	Description	Data Type	Range	Unit
m_Params for ‘LUT 2D’ mode	Total tuning parameters = (NUM_ELEMENTS + 1) * Table Height	Float	-99999.0 to 99999.0	None
m_Params for ‘LUT Index’ mode	Total tuning parameters = (NUM_ELEMENTS + 1) * Table Height * Table Depth	Float	-99999.0 to 99999.0	None

Control Interface

There are one or two control input values stored in the state memory for LUT based on the mode selected.

The first corresponds to the value that needs to be converted to control output, and the second determines which table index to use for the lookup operation.

Name	Description	Data Type	Range	Unit
m_states [0]	Corresponds to the control input value that needs to be modified.	Float	-32768.0 to 32767.0	None
m_states [1]	Determines which table index to use for interpolation.	Float	1.0 to 8.0	None

The number of control outputs are equal to the number of control inputs * the number of elements. When block control is enabled, the control outputs are grouped into groups of the number of elements, and the number of outputs will then be equal to the number of control inputs.

Create LUT Object

1. Load xAF DLL in GTT that supports LUT.
2. Open the Signal Flow Designer.
3. Drag and drop the LUT audio object into the Signal flow design view.
   
4. Verify that the object is created with no error messages.

The properties and compare to these defaults.

The additional variables below are not actually object variables; they only belong to the GUI object and are not covered by this document. See Components of Signal Flow Designerfor more information.

AudioObject Properties		Additional Variables
number of elements	1	Table Height	2
Object Mode	LUT 2D	Number of Control Inputs	1
		LUT Axis Linearity	0
		LUT Depth	1
		Lookup Method	1
		Block Control	0

Create LUT Object in Mode 0 (LUT 2D)

1. The object should already be in mode 0 (LUT 2D).
2. Verify that by default, there is one control input and one control output.
3. Change the number of elements to 3 and the number of control inputs to 2.
4. Verify that the object now has 6 control outputs.
   

Create LUT Object in Mode 1 (LUT Index)

1. Change the object mode to LUT Index.
2. Verify that the object now has 3 control inputs (2 LUT inputs and 1 Index input).
3. Change the number of elements to 3 and the number of control inputs to 2.
4. Verify that the object now has 6 control outputs.
   

The Control MultiAdder audio object provides the ability to manipulate input control signals. Refer description column of num elements for algorithm description.

Use Case: This object can be deployed whenever the addition of control inputs is required. Additionally, this object is used as the LUT Adder in Halosonic.

ControlMultiAdder Properties

Below table describes about the Control MultiAdder audio object audio object properties and functionality.

Properties	Description
Number of Elements	A minimum of three control inputs into the object are summed up and their sum is fed to the control output of the object. Each time the Control Multi Adder control input is set, it calls the corresponding control output. The object has 3 control inputs for elemental addition and forwards control value into an output. Example: If the numElements is 4, there will be 4 control outputs [y1, y2, y3 and y4] and 12 control inputs [x1 to x12]. The control outputs are computed as shown in the figure below. Maximum control inputs possible for a control multi adder instance are 255. For N elements specified from the configuration, 3N control input values would give N control output values. The number of control outputs is selected by numElements. The number of control inputs = 3 * numElements. The maximum number of control outputs is limited to 85, So the maximum number of control inputs is 85*3 = 255.
Display Name	Display name of the Control MultiAdder 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 Control MultiAdder audio object.

Additional parameters

There are no additional parameters available for Control MultiAdder audio object.

Tuning Parameters

There are no tuning parameters available for Control MultiAdder audio object.

Control Interface

The object supports configurable control inputs based on “Number of Elements”. By default, it has three control inputs. It has one control output.

Native Panel

Control MultiAdder audio object does not support native panel.

The Control Mixer audio object provides a mechanism to mix and route control signal from input to output. The mixer sums values from selected control inputs and pushes the sum to the output. Numbers of inputs and outputs are configurable via GTT. It enables N inputs to be connected to M outputs, which is configurable,e ranging from 1 to 254. If there isn’t any input signal associated with the output, the output wouldn’t be changed.

The non-weighted mode with one connected control input and output channel. Connection can be changed from the state variable window in GTT during tuning, but its impact will be visible once the input at that control pins is changed.

It takes control signals as inputs and emits control signals as outputs. Many inputs can also be connected to one output and output can be left unconnected also. It can copy any input to arbitrary number of outputs (from 0 to number_of_outputs). It means that some inputs can be copied to multiple outputs, or some inputs can be cut (not used further in the pipeline). On the other hand, one output can have at most single input connected to it. Below picture illustrates the idea.

Control Mixer Properties

Below table describes about the Control Mixer audio object properties and functionality.

Properties	Description
Display Name	Display the name of the control mixer audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode	Based on the weighing factor of the control inputs to be mixed, the Control Mixer works in two different modes. Non-weight mixer(default) Weight mixer

Mode

The Control Mixer supports two modes.

• Non-weight mixer(default)
• Weight mixer

Additional Parameter

Parameter	Description
Number of control input and output	The max input and output in the additional configuration is 100. Range: 1 to 254 The default number of control input and output pin is 1.

Tuning Parameters

There are no tuning parameters available for the Control Mixer audio object.

Control Interface

The default control input output is 1 and configurable through additional configuration from 1 to 254 (max).

Native Panel

The Control Mixer object has a native panel. It is used to organized into rows and columns, determined by the number of configured control inputs and outputs. For more details, refer to the Control Mixer Panel.

The Control Router audio object provide a mechanism to route control signal from input to output. The router allows to change path of control signal during runtime, which allows for flexibility when designing audio signal pipeline.

This object can be deployed whenever different control inputs to be routed to an object.

It can have arbitrary number of inputs and outputs ranging from 1 to 254 and enables the inputs to be cut or copied to any number of outputs.

Control Router Properties

Properties	Description
Display Name	Display name of the Control Router 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 Control Router audio object.

Additional Parameters

Parameter	Description
Number of control input and output	The max input and output in additional configuration is 100. Range: 1 to 254 The default number of control input and output pin is 1.

Tuning Parameters

There are no tuning parameters available for Control Router audio object.

Control Interface

Default control input output is 1 and configurable through additional configuration from 1 to 254 max.

Control objects category contains following audio objects.

 

The Control Math audio object provides the ability to manipulate input control signals.

Control Math Properties

Below table describes the Control Math audio object properties and functionality.

Properties	Description
Number of outputs/inputs	Enter the number of control outputs or inputs. When the object mode is set to ADD/SUBTRACT/MULTIPLY/MAXIMUM/MINIMUM/EQUAL/ AND/OR/NOR /NAND /XOR the input control pin is enabled. Input value ranges from 2 to 16. The output value is 1. The default value is set to 2. When the object mode is set to LIN2DB / DB2LIN /INVERT / RECIPROCAL / SQUARE / SQUAREROOT the input control pin is equal to the output control pin. When the object mode is set to DIVIDE/GREATER/LESS, the input control pins are 2 and the output control pin is 1. When the object mode is set to NOT/CTRLDELAY, the input and output control pin is 1. When the object mode is set to CTRLSPLIT, the input control pin is 1, and output control pins are configurable between 2 to 32. When the object mode is set to CTRLDUPLICATE, the input control pins are configurable between  1 to 16 and the output control pins are twice the input control pins. When the object mode is set to NONLINEARCLIP, the input control pins are 3, and the output control pin is 1. When the object mode is set to INDEX, the input control pins are configurable between  2 to 255, and the output control pins are 2.
Display Name	Display the name of the control math audio object in signal flow design. It can be changed based on the intended usage of the object.
Object Mode	Control Math audio object supports twenty-six modes of operation. This audio object can be configured in the SFD to operate in one of the following modes: Add Subtract Divide Multiply Minimum Maximum Lin2dB dB2Lin Invert Square Reciprocal SquareRoot And Or Xor Not Nand Nor Greater Less CtrlSplit CtrlDuplicate CtrlDelay NonLinearClip Equal Index The default object mode is set to Add.

Mode

The Control Math audio object supports the following modes.

Mode	Description
ADD	In this mode, control inputs into the object are summed up and their sum is fed to the output of the object.
SUBTRACT	The difference between the first control input and the summation of the remaining control inputs into this object is sent out at the output.
MULTIPLY	Takes in input controls and writes their product to the output of the object.
DIVIDE	Takes 2 input controls and writes the result of their division to the output. If the divisor is zero, the result is set to the maximum float value.
MAXIMUM	Takes the input controls and writes out the maximum of the values.
MINIMUM	Takes in input controls and writes out the minimum of the values.
LIN2DB	Takes a linear control value as an input and outputs its logarithmic equivalent to the specific output pin. If the input is less than or equal to zero, the result is set to zero.
DB2LIN	Takes a logarithmic control value as an input and outputs its linear equivalent to the specific output pin.
INVERT	Reads in a control value and outputs the negative (inverse) of that value to the specific output pin.
RECIPROCAL	Takes in a value, x, and outputs its reciprocal (1/x). If the input value is zero, the result is set to the maximum float value to the specific output pin.
SQUARE	Takes in a value, x, and outputs its squared value to the specific output pin.
SQUAREROOT	Takes in an input value, x, and outputs its square root. If the input is negative, the result is set to zero to the specific output pin.
AND	Takes in multiple inputs and outputs the logical AND operation of these inputs.
OR	Takes in multiple inputs and outputs the logical OR operation of these inputs.
XOR	Takes in multiple inputs (x1, x2, x3, xn) and outputs the logical XOR operation (((x1 xor x2) xor x3) xor xn) of these inputs.
NOT	Takes in an input, and outputs the NOT
NAND	Takes in multiple inputs (x1, x2, x3, xn) and outputs the logical NAND operation (((x1 nand x2) nand x3) nand xn) of these inputs.
NOR	Takes in multiple inputs (x1, x2, x3, xn) and outputs the logical NOR operation (((x1 nor x2) nor x3) nor xn) of these inputs.
GREATER	Takes in 2 inputs, and and outputs true if.
LESS	Takes in 2 inputs, and and outputs true if.
EQUAL	Takes in multiple inputs and outputs true if all the input values are equal.
SPLITTER	Takes in an input control and writes the output to a user-specified number of output pins.
DUPLICATE	Takes in a user-specified number of inputs and writes each input out to 2 output pins.
DELAY	Takes in a user setting delay (in ms) and writes out the output only after that delay time has passed.
NONLINEARCLIP	Takes in 3 inputs, x, min, and max. Provide the output as max if x is greater than max. Provide the output as min if x is less than min. Provide the output as x if x is greater than min and less than max.
INDEX	It takes in multiple control inputs and outputs two control values. The first control output returns the index of the minimum value among the control inputs. The second control output returns the index of the maximum value among the control inputs. In case of maximum or minimum values being the same, it returns the index of the first encounter.

Additional Parameters

The Control Math audio object supports additional configuration which allows to enable or disable Block Control. Which can be enabled or disabled by selecting between Block Control Disabled and Block Control Enabled. The object shall support Block Control in the following operating modes:

Block Control Enabled –

• Set “Object Mode” to EQUAL / AND / OR / NOR / NAND / XOR to enable the Block control, the number of input control pins can be grouped to one input block control pin.
• Set “Object Mode” to LIN2DB / DB2LIN /INVERT / RECIPROCAL / SQUARE / SQUAREROOT to enable the Block control, the number of input and output control pins can be grouped to one input block control pin and one output block control pin respectively.

By default, the Block Control function is disabled.

Tuning Parameters

There are no tuning parameters available for the Control Math audio object.

Control Interface

The object supports  configurable control inputs and control outputs based on configured mode.

Refer Control Math Properties section for detailed explanation regarding number of control inputs/outputs based on modes

Native Panel

Control Math audio object does not support the native panel.