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

CODE

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

CODE

 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.