MapperControl

Overview

Multi-channel control signal converter

Discussion

This is a control subsystem module with Router, Type Conversion, Clipper and Scale Offset modules. Input of this module is multichannel control pin of any data type and output is the mono channel control pin of float data type. It has control variables channelNum, inputMin, inputMax, outputMin and outputMax. channelNum to select the channel from multichannel input pin. inputMin and inputMax to control the lower and upper thresholds ClipAsym module. outputMin and outputMax to control the gain and offset of ScalerOffset module with the equation

gain = (outputMax - outputMin)/(inputMax - inputMin) offset = outputMin - (gain * inputMin)

Module Pack

Advanced

ClassID

classID = 1371

Type Definition

typedef struct _ModuleMapperControl
{
ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
INT32 channelNum;                             // Select the channel from the input control bus
FLOAT32 inputMin;                             // Minimum input value
FLOAT32 inputMax;                             // Maximum input value
FLOAT32 outputMin;                            // Minimum output value
FLOAT32 outputMax;                            // Maximum output value
awe_modRouterInstance *router; // Channel routing without smoothingawe_modTypeConversionInstance *toFloat; // Converts between numeric data typesawe_modClipAsymInstance *clip; // Asymmetric clipper module with separate upper and lower clipping thresholdsawe_modScaleOffsetInstance *scaleOffset; // Scales a signal and then adds an offset} ModuleMapperControlClass;

Variables

Properties

Name	Type	Usage	Default Value	Range
channelNum	int	parameter	1	1:1
inputMin	float	parameter	-1	-1:1
inputMax	float	parameter	1	-1:1
outputMin	float	parameter	-1	-1:1
outputMax	float	parameter	1	-1:1

Pins

Input Pins


Name	in
Description	Input audio
Data type	{float, int, fract32}
Channel range	Unrestricted
Block size range	1
Sample rate range	Unrestricted
Complex support	Real

Output Pins


Name	out
Description	Output audio
Data Type	float

Scratch Pins


Channel Count	1
Block size	1
Sample rate	48000

Matlab Usage

File Name: mapper_control_module.m 
 SYS = mapper_control_module(NAME) 
 Creates a subsystem module with Router, clipper and scale offset modules. 
 Arguments: 
    NAME - name of the module.