SoloMuteFract32

Overview

Solo and mute N channel signals

Discussion

Solo and Mute control module. This modules allows you to listen to individual channels ("solo") or mute them. When the second argument NUMPINS is 1, then the solo and mute control is applied to each individual channel. Otherwise the solo and mute control is applied to each individual input pin as a whole. The array .isMuted is used for mute control and the array .isSolo is for solo control. When both are selected, mute has higher priority over solo. In all cases, the array length is updated by the prebuild function.

The module does smooth muting and unmuting. The speed of the smoothing operation is set by the .smoothingTime variable. The module's set function translates the smoothingTime to an internal smoothingCoeff. When the module is built it starts out in a converged state.

By default, the inspector for the module has the control checkboxes organized in a vertical stack. By setting the optional third argument TRANSPOSE = 1 turns the control into a horizontal stack.

Type Definition

CODE

typedef struct _ModuleSoloMuteFract32
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    FLOAT32 smoothingTime;                        // Time constant of the smoothing process
    INT32 numControls;                            // Number of individual mute controls
    fract32 smoothingCoeff;                       // Smoothing coefficient.
    INT32* isSolo;                                // Boolean that controls pin solo. One per each pin.
    INT32* isMuted;                               // Boolean that controls pin muted or unmuted. One per each pin.
    fract32* currentGain;                         // Instantaneous gain applied by the module. This is also the starting gain of the module.
    fract32* gain;                                // Target gain.
} ModuleSoloMuteFract32Class;

Variables

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
smoothingTime	float	parameter	0	10	0:1000	msec
numControls	int	const	1	1	Unrestricted
smoothingCoeff	fract32	derived	1	0.002081	Unrestricted
isSolo	int*	parameter	0	[1 x 1]	0:1
isMuted	int*	parameter	0	[1 x 1]	0:1
currentGain	fract32*	state	1	[1 x 1]	0:1	linear
gain	fract32*	derived	1	[1 x 1]	0:1	linear

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: solo_mute_fract32_module.m

CODE

 M=solo_mute_fract32_module(NAME, NUMPINS, NUMCHANNELS, TRANSPOSE)
 This module allows you to solo or mute an N channel signal.
 Arguments:
    NAME - name of the module.
    NUMPINS - optional argument that specifies the number of input pins.
       When NUMPINS is 1, the solo and mute control apply to each individual
       channel within the input pin.
       When NUMPINS is more than 1, the solo and mute control apply to
       those input pins. By default, NUMPINS = 1.
    NUMCHANNELS - optional argument that specifies the initial number
       of channels in the wire.  When the system is built, the number
       of channels is derived by pin propagation.  This value is only
       for the initial behavior before the system is built.  By default,
       NUMCHANNELS = 2.
    TRANSPOSE - an optional argument which controls how the inspector
       for the module is drawn.  By default, if there are N channels
       then the inspector control is a vertical stack of N checkboxes.
       (TRANSPOSE = 0 by default).  If TRANSPOSE = 1, then the inspector
       is drawn as a horizontal array of N checkboxes.
 AudioWeaverModule [This tag makes it appear under awe_help]