This version (02 Aug 2012 20:57) was approved by Brett Gildersleeve.The Previously approved version (02 Aug 2012 20:56) is available.Diff

Generic Gain Envelope

Click here to return to the Volume Controls section.

The Generic Gain Envelope generates a fully-programmable envelope and applies it to an input signal.genericgainenvelope033.jpg

There are two versions of the algorithm available:

  • Generic Gain Envelope Alg
  • Generic Gain Envelope Alg EndlessLoop

Input Pins

NameFormat [int/dec] - [control/audio]Function Description
Pin 0: Control Inputint - controlSwitch used to activate envelope
Pin 1: Audio Inputdecimal - audioInput audio signal

Output Pins

NameFormat [int/dec] - [control/audio]Function Description
Pin 0: Control Inputdecimal - audioAudio output signal with gain envelope applied

GUI Controls

GUI Control NameDefault ValueRangeFunction Description
Maximum Time (ms)1104240 to 440Controls the length of the gain envelope
Gain (dB)n/a-120 to 24Controls the gain of the corresponding point on the envelope
Time (ms)n/a0 to maxControls the time of the corresponding point on the envelope

DSP Parameter Information

GUI NameCompiler NameFunction Description
n/aGenericGainEnvelopegainincrementtableControls the way that the output gain changes from point to point on the envelope
n/aGenericGainEnvelopestartgainControls the starting gain of the envelope
n/aGenericGainEnvelopegaintableStores the values that control the output gain of the algorithm

Algorithm Description

The Generic Gain Envelope algorithm has a fully programmable gain envelope. The envelope is accessible by clicking the cell’s icon.

The length of the envelope is controlled by the Maximum Time control, which is set in milliseconds.

Points on the curve can be moved by click-dragging. New points can be added by double-clicking. Points can be removed by right-clicking and selecting “remove point.” In this case, the point closest to the mouse cursor will be removed. The envelope must have at least 3 points. Point values can be fine-tuned using the text input boxes on the right side of the envelope control window.

When the control input goes to 1, the gain envelope begins. When the control input goes to 0, the gain envelope stops, regardless of whether the envelope has completed or not.

In the case of the Generic Gain Envelope Alg EndlessLoop algorithm, the envelope will loop continuously until the control input goes to 0.

The example below shows the algorithm’s input and output signals using the gain envelope shown above.


The following schematic image shows the Generic Gain Envelope cell being controlled by a 28.0 On/Off Switch and applied to a Sine Tone. The processed audio is output to a DAC. The schematic below uses the Switch, Generic Gain Envelope, Sine Tone, and Output cells.

Algorithm Details

Toolbox PathSources – Chime – Modulated Frequency and Gain
Cores SupportedADAU144x
“Grow Algorithm” Supportedyes - see Algorithm Growth Information
“Add Algorithm” Supportedno
Subroutine/Loop Basedno
Program RAM44*
Data RAM9*
Parameter RAM15*

*Numbers are based on one instance of the algorithm with no additional “add” or “grow”

Algorithm Growth Information

DescriptionAdds a new input pin and a new output pin
Program RAM Repetition2 per growth
Data RAM Repetition1 per growth
Parameter RAM Repetitionnone
resources/tools-software/sigmastudio/toolbox/volumecontrols/genericgainenvelope.txt · Last modified: 02 Aug 2012 20:57 by Brett Gildersleeve