Document toolboxDocument toolbox

(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.

Â