Overview
General purpose scaler with separate gains per channel
Discussion
General purpose scaler (or gain) module for floating-point signals. This module has a single gain (masterGain) which is applied all channels plus a separate per channel gain (trimGain). For each channel, masterGain and trimGain[n] is combined to form the target gain value.
...
The module argument NUMCHANNELS sets the initial number of channels. This allows you to configure the module for the proper number of channels before the system is built. After the system is built, NUMCHANNELS is no longer used and the number of channels is determined from the input wire.
Type Definition
| Code Block |
|---|
typedef struct _ModuleScalerNV2
{
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
FLOAT32 masterGain; // Overall gain to apply.
FLOAT32 smoothingTime; // Time constant of the smoothing process (0 = unsmoothed).
INT32 isDB; // Selects between linear (=0) and dB (=1) operation
FLOAT32 smoothingCoeff; // Smoothing coefficient.
FLOAT32* trimGain; // Array of trim gains, one per channel
FLOAT32* targetGain; // Computed target gains in linear units
FLOAT32* currentGain; // Instanteous gains. These ramp towards targetGain
} ModuleScalerNV2Class; |
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
masterGain | float | parameter | 0 | 0 | -24:24 | dB |
smoothingTime | float | parameter | 0 | 10 | 0:1000 | msec |
isDB | int | parameter | 0 | 1 | 0:1 | |
smoothingCoeff | float | derived | 1 | 0.002081 | Unrestricted | |
trimGain | float* | parameter | 0 | [1 x 1] | -24:24 | dB |
targetGain | float* | derived | 1 | [1 x 1] | Unrestricted | |
currentGain | float* | state | 1 | [1 x 1] | Unrestricted |
Pins
Input Pins
Name: in
Description: audio input
...
Complex support: Real and Complex
Output Pins
Name: out
Description: audio output
Data type: float
MATLAB Usage
File Name: scalern_v2_module.m
...