Code quality and maintenance

Renamed Enabled/Disabled values to Activated/Deactivated.
Trivially Britified the English in some places and fixed some typos.
Improved dB/amplitude conversion precision and speed in some places.
Removed slow and unprecise "fastReciprocal" function, replaced it with fast and precise "slow 1/x" instead.
Various other minor code, performance and/or precision improvements.
Advanced version number to 1.8.3.

Author: chkhld

Clipper/hard_clipper.jsfx

@@ -1,5 +1,5 @@
 desc:       Hard Clipper
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing gain amplitude clipper distortion saturation
 link:       https://github.com/chkhld/jsfx/
@@ -16,7 +16,7 @@ about:
  smoother, but it comes at the cost of losing true 0 dBfs
  peak safety from all the filtering. If you need reliable
  0 dBfs peak safety, then load another clipper after this,
- or just simply disable oversampling.
+ or just simply deactivate oversampling.
 
  Since hard clipping causes lots of aliasing, I've added
  a DC Blocker, can't hurt to have it ready, just in case.
@@ -25,7 +25,7 @@ about:
 slider1:dBCeil=0<-48, 0,0.01> Ceiling dBfs
 slider2:dBGain=0<  0,48,0.01> Boost dB
 slider3:ovs=0<0,1,{Off,On}> Oversampling
-slider4:blocker=0<0,1,{Enabled,Disabled}> DC Blocker
+slider4:blocker=0<0,1,{Activated,Deactivated}> DC Blocker
 
 in_pin:left input
 in_pin:right input
@@ -38,7 +38,7 @@ out_pin:right output
   ups = 100000;
 
   // Decibel to gain factor conversion
-  function dBToGain (decibels) (10.0 ^ (decibels / 20.0));
+  function dBToGain (decibels) (pow(10, decibels * 0.05));
 
   // Hard clipping function with ceiling
   function hardclip ()
@@ -147,7 +147,7 @@ out_pin:right output
     );
   );
 
-  // If DC blocking enabled
+  // If DC blocking activated
   blocker == 0 ?
   (
     // Run the DC blocker on each sample

Clipper/knee_clipper.jsfx

@@ -1,5 +1,5 @@
 desc:       Knee Clipper
-version:    1.8.2b
+version:    1.8.3
 author:     chokehold
 tags:       processing gain amplitude clipper distortion saturation
 link:       https://github.com/chkhld/jsfx/
@@ -11,7 +11,7 @@ about:
 
  Hard clippers are usually lamented about as producing digital, cold and nasty
  sound. But they are perfect for very short overs, as they will not affect the
- signal in any way before overs actually happen, and only those occuring overs
+ signal in any way before overs actually happen, and only those apparent overs
  will be clipped, nothing else. You can get away with lots of hard clipping on
  percussive and transient-rich material like drums. For more consistent things
  like a bass track or a full mix, hard clipping is not ideal as it tends to be
@@ -48,14 +48,14 @@ about:
  Any signal within the lower and upper knee threshold range is gently rescaled
  to fit below the ceiling, even if the signal originally shot past the ceiling,
  within the confines of the [ceiling,upper knee threshold] range. This imparts
- a little bit of soft clipping saturation, and preverves the life in very loud
+ a little bit of soft clipping saturation, and preserves the life in very loud
  transients significantly better than other, more trivial clipping methods.
 
  The "super soft" option decides how the part of the signal within the knee is
- rescaled. With the "super soft" option disabled, the rescaling is more linear
+ rescaled. With the "super soft" option deactivated rescaling gets more linear
  which means the transition into hard clipping occurs later but faster, so the
  signal can become slightly louder before the hard distortion kicks in, but at
- the cost of being harsher and much more immediate. With "super soft" enabled,
+ the cost of being harsher and much more immediate. With "super soft" selected,
  rescaling inside the knee uses cosine interpolation to transition between the
  unclipped and clipped states more gradually. This sounds less harsh but comes
  at the cost of some output volume.
@@ -82,12 +82,12 @@ about:
  In the metering section, the ceiling is displayed as a red line while no knee
  is set. Anything above the red line will be hard-clipped. As soon as there is
  a knee present, the ceiling turns orange, because it now no longer represents
- the point of hard clipping. With knee enabled, the yellow marker line left of
+ the point of hard clipping. With knee selected the yellow marker line left of
  the ceiling line visualizes the onset of the knee. Signal exceeding that line
  is gently compacted until it hits the upper limit of the knee range, which is
  displayed as the red marker line to the right of the ceiling. Anything beyond
  the red line will be hard-clipped, even with the knee, even with "super soft"
- mode enabled.
+ mode activated.
 
  The green bar in the metering section reflects the incoming audio signal of a
  plugin input channel. The blue bar underneath it reflects the outgoing signal

Clipper/sine_clipper.jsfx

@@ -1,5 +1,5 @@
 desc:       Sine Clipper
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing gain amplitude clipper distortion saturation
 link:       https://github.com/chkhld/jsfx/
@@ -54,7 +54,7 @@ about:
  those aforementioned sigmoids tend to cause. The transition into distortion
  also happens noticeably smoother.
 
- TL;DR: More headroom, louder signal, fewer artifacts, softer clipping onset,
+ TL;DR: More headroom, louder signal, fewer artefacts, softer clipping onset,
  less "buzz". There's no reason to keep using regular sigmoid-based clippers
  anymore like a basic boomer. ;)
 
@@ -68,11 +68,10 @@ slider2:dBGain=0<-48,48,0.01>Boost [dB]
 @init
 
   // Convenience variables for CPU economy during processing
-  halfPi     = $pi * 0.5;
-  oneOverSix = 1/6;
+  halfPi = $pi * 0.5;
 
   // Converts dB values to float gain factors
-  function dBToGain (decibels) (pow(2, decibels * oneOverSix));
+  function dBToGain (decibels) (pow(10, decibels * 0.05));
 
   // SINE CLIPPING -------------------------------------------------------------
   //

Clipper/soft_clipper.jsfx

@@ -1,5 +1,5 @@
 desc:       Soft Clipper
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing gain amplitude clipper distortion saturation
 link:       https://github.com/chkhld/jsfx/
@@ -25,7 +25,7 @@ about:
  Saturation and soft-clipping can also introduce evil aliasing,
  that's when newly generated harmonics are so high in frequency
  that they shoot past 22 kHz and could not possibly be handled
- anymore by the samplerate, so they "fold back" into the lower
+ anymore by the sample rate so they "fold back" into the lower
  part of the frequency spectrum where they can cause havoc and
  destruction by becoming audible, sitting in unharmonic spaces
  and even cancelling out signal that you actually want to hear.
@@ -74,8 +74,8 @@ slider1:dBCeil=0<-48, 0,0.01> Ceiling dBfs
 slider2:dBGain=0<  0,48,0.01> Boost dBfs
 slider3:ovs=1<0,4,{Off,2x,4x,8x,16x}> Oversampling
 slider4:filter=1<0,3,{Relaxed,Normal,Heavy,Insane}> Filtering
-slider5:blocker=1<0,0,{Disabled,Enabled}> DC blocker
-slider6:hard=0<0,1,{Disabled,Enabled}> Hard clipping
+slider5:blocker=1<0,0,{Deactivated,Activated}> DC blocker
+slider6:hard=0<0,1,{Deactivated,Activated}> Hard clipping
 
 in_pin:left input
 in_pin:right input
@@ -95,7 +95,7 @@ out_pin:right output
   orderDn = 1;
 
   // Decibel to gain factor conversion
-  function dBToGain (decibels) (10.0 ^ (decibels / 20.0));
+  function dBToGain (decibels) (pow(10, decibels * 0.05));
 
   // Hyperbolic tangent approximation, used for soft clipping.
   //
@@ -308,15 +308,15 @@ out_pin:right output
     );
   );
 
-  // If DC blocking enabled
+  // If DC blocking activated
   blocker == 1 ?
   (
     // Run the DC blocker on each sample
     spl0.dcBlocker();
     spl1.dcBlocker();
   );
 
-  // If hard clipping is enabled
+  // If hard clipping is activated
   hard == 1 ?
   (
     // Hard-clip the output to avoid any distortion outside of this

Clipper/staging_clipper.jsfx

@@ -124,7 +124,7 @@ slider6:dBtrim=0<-24,24,0.01>Output trim [dB]
 
   // The actual clipping function.
   //
-  // This could be optimized into a single line, but I'll leave it
+  // This could be optimised into a single line, but I'll leave it
   // spread over several lines in order to explain what's going on.
   function clip (sample) local (polarity)
   (
@@ -136,19 +136,11 @@ slider6:dBtrim=0<-24,24,0.01>Output trim [dB]
 
     // Clip the boosted sample to stay below the ceiling.
     //
-    // Instead of slow and expensive conditional if/elseif/etc. branching,
-    // this uses a highly performant set of additions and multiplications
-    // which amounts to the same as conditional branching. If the type==x
-    // conditions are false i.e. 0, the function they're multiplied by is
-    // not even called, let alone processed or evaluated. 0 * anything is 
-    // always 0, so the entire ((type==x) * something) is optimized to 0.
-    // Only where the type==x condition is true i.e. 1, the function will
-    // actually be processed and evaluated - and multiplied by 1 which of 
-    // course will also be optimized out, because 1 * something is always
-    // just that something. Ess emm arr tee.
-    sample = (type==0) * sineClip(sample) + 
-             (type==1) * softClip(sample) + 
-             (type==2) * hardClip(sample);
+    (type == 0) ? (sample = sineClip(sample))
+    :
+    (type == 1) ? (sample = softClip(sample))
+    :
+    (type == 2) ? (sample = hardClip(sample));
 
     // Apply the make-up gain that will shift the output level up or down 
     // based on where the ceiling is, so that the output ceiling always

Distortion/foldback_distortion.jsfx

@@ -1,5 +1,5 @@
 desc:       Foldback Distortion
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing distortion foldback
 link:       https://github.com/chkhld/jsfx/
@@ -27,7 +27,7 @@ about:
 // ----------------------------------------------------------------------------
 slider1:dBCeiling=0<-48, 0,0.01> Ceiling dBfs
 slider2:dBBoost=0<  0,48,0.01> Boost dB
-slider5:blocker=0<0,1,{Enabled,Disabled}> DC Blocker
+slider5:blocker=0<0,1,{Activated,Deactivated}> DC Blocker
 
 in_pin:left input
 in_pin:right input
@@ -37,7 +37,7 @@ out_pin:right output
 @init
 
   // Decibel to gain factor conversion
-  function dBToGain (decibels) (10.0 ^ (decibels / 20.0));
+  function dBToGain (decibels) (pow(10, decibels * 0.05));
 
   function foldback () instance (signum)
   (
@@ -78,7 +78,7 @@ out_pin:right output
   spl0.foldback();
   spl1.foldback();
 
-  // If DC blocking enabled
+  // If DC blocking activated
   blocker == 0 ?
   (
     // Run the DC blocker on each sample

Dynamics/bus_comp.jsfx

@@ -1,5 +1,5 @@
 desc:       Bus Compressor
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing compressor dynamics gain
 link:       https://github.com/chkhld/jsfx/
@@ -36,7 +36,7 @@ about:
  M+S mode, the stereo field can appear "widened", depending on how
  much each channel is compressed.
 
- With stereo linking disabled, both L+R channels will be processed 
+ With stereo linking turned off the L+R channels will be processed 
  individually. Fading in stereo linking will make the detector act
  on a mix of the L+R channels increasingly. If you have incoherent
  signals (e.g. two separate guitars) on both channels, you'll most
@@ -59,7 +59,7 @@ about:
  the compressor squashes the signal, the more soft saturation will
  be introduced into the material.
 
- Hard 0 dBfs output clipping may be enabled if so desired, but may
+ Hard 0 dBfs output clipping may be selected if so desired but may
  be a bit harsh and buzzy sounding. Use the Makeup gain to "boost"
  the material into this, or don't.
 
@@ -79,7 +79,7 @@ slider9: linkAmount=100<0, 100, 1>Stereo link [%]
 slider10:instability=100<0,100,0.01>Instability [%]
 slider11:saturation=100<0,100,0.01>Saturation [%]
 slider12:dBTrim=0<-24, 24, 0.01>Makeup gain [dB]
-slider13:clip=0<0,1,{Disabled,Hard clip 0 dBfs}>Clip output
+slider13:clip=0<0,1,{Deactivated,Hard clip 0 dBfs}>Clip output
 slider14:pctMix=100<0,100,0.01>Dry/wet mix [%]
 
 in_pin:Input L

Dynamics/consolidator.jsfx

@@ -1,5 +1,5 @@
 desc:       Consolidator
-version:    1.8.2
+version:    1.8.3
 author:     chokehold
 tags:       processing compressor dynamics gain limiter maximizer
 link:       https://github.com/chkhld/jsfx/
@@ -22,7 +22,7 @@ about:
  Stereo linking is calculated at each compressor stage independently. Linking
  L+R channels in the detector makes the stereo image more stable, but it robs
  the compressors of possible gain reduction. Rule of thumb: to squash signals
- as much as possible ("maximize"), use low or no stereo linking. To help keep
+ as much as possible ("maximise"), use low or no stereo linking. To help keep
  a signal's stereo field intact, use high or full stereo linking.
 
  Makeup gain is just a simple volume adjustment. Don't get scared when things
@@ -48,7 +48,7 @@ out_pin:Output R
 
 @init
 
-  // Stop Reaper from re-initializing the plugin every time playback is reset
+  // Stop Reaper from re-initialising the plugin every time playback is reset
   ext_noinit = 1;
 
   // Various convenience constants
@@ -58,7 +58,7 @@ out_pin:Output R
   rcpSqrt2 = 0.7071067812; // Reciprocal constant 1.0 / sqrt(2.0)
 
   // Converts dB values to float gain factors
-  function dBToGain (decibels) (10.0 ^ (decibels / 20.0));
+  function dBToGain (decibels) (pow(10, decibels * 0.05));
 
   // Converts float gain factors to dB values
   function gainTodB (float) local (below)
@@ -76,9 +76,6 @@ out_pin:Output R
   function msToL (sampleMid,  sampleSide)  ((sampleMid  + sampleSide)  * rcpSqrt2);
   function msToR (sampleMid,  sampleSide)  ((sampleMid  - sampleSide)  * rcpSqrt2);
 
-  // Accelerated 1/value calculation
-  function fastReciprocal (value) (sqr(invsqrt(value))); 
-  
   // SIDECHAIN FILTER
   //
   // Simple Biquad HP filters used in the sidechain circuit.
@@ -87,8 +84,8 @@ out_pin:Output R
   //
   function eqHP (Hz, Q) instance (a1, a2, a3, m0, m1, m2) local (g, k)
   (
-    g = tan(halfPi * (Hz / srate)); k = fastReciprocal(Q);
-    a1 = fastReciprocal(1.0 + g * (g + k)); a2 = a1 * g; a3 = a2 * g;
+    g = tan(halfPi * (Hz / srate)); k = 1.0 / Q;
+    a1 = 1.0 / (1.0 + g * (g + k)); a2 = a1 * g; a3 = a2 * g;
     m0 = 1.0; m1 = -k; m2 = -1.0;
   );
   //
@@ -109,8 +106,8 @@ out_pin:Output R
   function attRelSetup (msAttack, msRelease) instance (coeffAtt, coeffRel) local ()
   (
     // Set attack and release time coefficients
-    coeffAtt = exp(-1000 * fastReciprocal(msAttack  * srate));
-    coeffRel = exp(-1000 * fastReciprocal(msRelease * srate));
+    coeffAtt = exp(-1000 / (msAttack  * srate));
+    coeffRel = exp(-1000 / (msRelease * srate));
   );
   //
   // This calculates the new envelope state for the current sample.
@@ -137,7 +134,7 @@ out_pin:Output R
   function gainCalcSetup (dBThreshold, fullRatio, dBKnee) instance (threshold, ratio, knee, kneeWidth, kneeUpper, kneeLower) local ()
   (
     threshold = dBThreshold;            // signed dBfs
-    ratio = fastReciprocal(fullRatio);  // 1/x --> compression < 1, expansion > 1
+    ratio = 1.0 / fullRatio;  // 1/x --> compression < 1, expansion > 1
     knee = dBKnee;
     kneeWidth = knee * 0.5;
     kneeUpper = threshold + kneeWidth;