Envelope Types

From BeepBox Wiki

Envelopes, as mentioned in their page, are a system of controlling multiple settings of an instrument during the song in BeepBox. This page focuses on documenting the types of envelopes and their behaviors. First, their properties should be explained.

Details

  • Common Naming Scheme

Envelope types in BeepBox (and its mods) have different names and numbers which define them. The first part is typically the envelope type's name (e.g. Punch, Twang, Decay). Each envelope type has a different behavior, with some envelopes using the behavior of something similar to ADSR (like Twang or Flare), or other envelopes that behave like LFOs (Tremolo). However, some envelope types do not have a behavior like standard envelope types. For example, Note Size, which changes the target's value based on a note's "volume" or "fade". The number at the end of most envelope names (e.g. Twang 1 vs Twang 3) often corresponds to their speed. Most often, higher values are slower than lower values. This only remains true for most envelopes however, as envelopes can have no speed-defining numbers (Punch), or their numbers sometimes serve a different purpose (e.g. Tremolo 1 to 3 acts like a full tremolo with the numbers corresponding to its speed. However, Tremolo 4 to 6 are the same speeds as the previous three, but the intensity of the tremolo is halved.).

  • How Envelope Types are Constructed

Each envelope type is given its behavior by a math function. These functions define the behavior of the envelope type. Every tick, the value of the envelope target is set to and interpolated at the current time value the envelope type's function is on. In the envelope type list below, recreations of these functions in Desmos (graphing calculator) will be available for viewing the properties of each envelope type.

  • Extra Info About List

Other BeepMods may have more unique envelopes with other special attributes that may potentially be useful. Below lies the envelope type list, which only contains envelopes that are usable in the BeepBox V4.0 envelope system (so e.g. Sandbox's unique envelope types like "rev" are not available in this list unless a mod implements them into the new system). Envelopes will also be listed with a "group" assigned to them. These are the following groups:

  • None - Envelope types that do nothing or remain at a constant value forever.
  • ADSR - Envelope types that have simple properties, e.g. fading in and/or out, or momentarily amplifying the value of the target.
  • LFO - Envelope types that repeatedly fade in and out.
  • Special - Envelope types that select value by manual input rather than a function giving values.
  • Incremented - Envelope types that change value in steps rather than in curves.
  • Ignorant - Envelope types that do not restart at the beginning of a note.

Envelope Type List

Type Details Group Math Function Applicable BeepMods
None No functionality; this envelope is disabled. None 1 remains constant. All Beepmods
Note Size Controls the envelope target's value based on a note's size/volume. If this envelope type is used on an instrument, it'll stop the note volume <- note fade/size relationship on the instrument unless placed back, meaning this envelope type also has a functionality even when there is no envelope target selected. Setting the target to note volume on the note size envelope type adds this behavior back. Used to be named "Custom". Special Goes from 0-1 by note volume/fade. BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Pitch Controls the envelope target's value based on the pitch, or vertical placement of a note. Extra settings pertaining to this envelope can be found in a dropdown next to the envelope. Special Goes from 0-1 in the set pitch range. Below starting point will be set to zero and above ending point will be set to one (opposite if inverted). Slarmoo's Box, VoxBox
Punch Momentarily amplifies the value of the envelope target. ADSR Punch function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Flare Fades in, and then slowly fades out again. ADSR Flare function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Twang Decays from 1 to 0, slowing down the closer it is to 0. ADSR Twang function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Swell Fades in from 0 to 1, slowing down the closer it is to 1. ADSR Swell function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box
Tremolo Type 1 (0-3) Fades in and out from 0 to 1 and back repeatedly. LFO + Ignorant Tremolo Type 1 function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Tremolo Type 2 (4-6) Behaves the same way as Tremolo Type 1, except the intensity is halved, with the envelope now fading in and out from 0.5 to 1 repeatedly. LFO + Ignorant Tremolo Type 2 function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Decay Similar to Twang, but the fade out to 0 is much quicker. ADSR Decay function BeepBox, JummBox, GoldBox, PaandorasBox, FoxBox, MarioPaintBox, TETBox, UltraBox, Midbox, Dogebox2, AbyssBox, Unbox, BariBox, BoxBeep, BirdBox, AwesomeBox, Slarmoo's Box, VoxBox
Blip (JummBox) Momentarily sits at 1, then instantly drops to 0. Incremented JummBox Blip function JummBox, UltraBox, AbyssBox, Unbox, BariBox, AwesomeBox, Slarmoo's Box, VoxBox
Wibble A combination of Tremolo and Twang, with the envelope going from 1 to 0 with a vibrato-like descent. ADSR + LFO Wibble function GoldBox, UltraBox, AbyssBox, Unbox, BariBox, Slarmoo's Box, VoxBox
Linear Descends downwards in a straight line to 0. ADSR Linear function GoldBox, UltraBox, AbyssBox, Unbox, BariBox, Slarmoo's Box, VoxBox
Rise Rises upwards in a straight line to 1. ADSR Rise function GoldBox, UltraBox, AbyssBox, Unbox, BariBox, Slarmoo's Box, VoxBox
Tripolo, Pentolo, Flutter, and Water-y Flutter (All Types) Same as Tremolo Types 1 and 2, but with varying speeds. Tripolo and Pentolo originated from Sandbox, while Flutter and Water-y Flutter originated from TodBox. LFO + Ignorant Refer to Tremolo. UltraBox, AbyssBox, Unbox, BariBox, Slarmoo's Box, VoxBox
Flute Same as Wibble but with different speeds. Created with the purpose of originating from ModBox, although the envelopes are not the same. The old flute envelope had a linear dip downwards, and when it hit zero, it raised back upwards infinitely based on time. ADSR + LFO Refer to Wibble. Old ModBox Flute function UltraBox, AbyssBox, Unbox, BariBox, Slarmoo's Box, VoxBox
Blip (ModBox) An old transition type from ModBox that had been translated into an envelope (meant to target note volume). Similar to Punch in the way the envelope's value is momentarily amplified, although the amplification is more powerful and there is a small dip post-amplification. In ModBox, this dip is actually an artifact from its limiter, but remains as an extra behavior on the translated envelope. ADSR ModBox Blip function (May be inaccurate.) Midbox
ModBox Trill A transition type from ModBox that had been translated into an envelope (meant to target note volume). Fades out to 0 in a quick linear fashion upon being played. When it reaches 0, the envelope's value instantly rises back up and remains at a constant 1. ADSR ModBox Trill function (May be inaccurate.) Midbox
ModBox Click A transition type from ModBox that had been translated into an envelope (meant to target pitch shift). Akin to Punch and ModBox Blip, this envelope also has a brief moment of very high amplification much stronger than punch, which is then put on pitch shift to replicate a "click" sound. ADSR Refer to Punch. Midbox
ModBox Bow A transition type from ModBox that had been translated into an envelope (meant to target pitch shift). An extremely fast counterpart to Rise. ADSR ModBox Bow function (May be inaccurate.) Midbox
Slow Swell A much slower version of Swell. ADSR Refer to Swell. Midbox
Blip (Dogebox2) Similar to Flare, but the fade out is straight like Linear. ADSR Dogebox2 Blip function Dogebox2
Clap Similar to Twang but mirrored several times very quickly at the start, making a chaotic stuttering sound. ADSR Clap function Dogebox2