(8.D.2.1) MixerDenseFract32
Overview
M-input x N-output mixer
Discussion
This module implements a fixed point full M-input x N-output mixer with a total of MxN coefficients. The coefficients are contained in the coeffs matrix with the gain from the ith input to the jth output is found at coeffs(i, j). Note, this mixer is not smoothly updating and changes to the gain coefficients may result in audible clicks. Use the MixerSmoothedFract32 for clickless updates.
The module's processing function has been optimized for a large number of non-zero coefficients. If you expect to have a sparse gain matrix, then the MixerV3Fract32 module is a better choice.
When the module is bypassed, it copies the ith input channel to the ith output channel. If the module has more output channels than input channels, the remaining output channels are set to 0.
Type Definition
typedef struct _ModuleMixerDenseFract32
{
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
INT32 postShift; // Number of bits to shift
FLOAT32* gain; // Array of linear gain factors. The size of the array is numIn * numOut.
fract32* gainFract32; // Array of linear gain factors in fractional representation. The size of the array is numIn * numOut.
} ModuleMixerDenseFract32Class;
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
postShift | int | derived | 1 | 1 | Unrestricted | Â |
gain | float* | parameter | 0 | [1 x 2] | -60:20 | Â |
gainFract32 | fract32* | derived | 1 | [1 x 2] | Unrestricted | Â |
Pins
Input Pins
Name: in
Description: audio input
Data type: fract32
Channel range: Unrestricted
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real
Output Pins
Name: out
Description: audio output
Data type: fract32
MATLAB Usage
File Name: mixer_dense_fract32_module.m
M=mixer_dense_fract32_module(NAME, NUMOUT)
Creates a multichannel mixer module for use in Audio Weaver. This is
the dense mixer which has been optimized for a non sparse gain matrix.
The mixer has one input and one output pin. Each of these pins can
contain multiple interleaved channels. The number of input channels is
determined by the upstream audio module. However, you must specify the
number of output channels at construction time. Arguments:
NAME - name of the module.
NUMOUT - number of output channels.
Â