Release.

README.md

@@ -127,6 +127,12 @@ Includes all the features of VCO, adding:
 
 The context menu option "DC offset correction" works as documented on <a href="#vco">VCO</a>.
 
+The context menu option "Mix output processing" sets how the mix output is scaled or clipped.  VCV Rack modules generally [should not output signals exceeding +/-12 volts](https://vcvrack.com/manual/VoltageStandards#Output-Saturation), and oscillators typically output +/-5 volts.  However, XCO's mix output combines four oscillators, and can easily exceed these values.  "Mix output processing" sets how to deal with this:
+  - "Scaled to +/-5V" (default): the output is directly scaled down to +/-5V (like a regular oscillator) when it would otherwise exceed that range (it will not scale up; it is possible to reduce the output below this range with the MIX controls).  The scaling is updated once per oscillator cycle, and abrupt parameter changes can confuse it; in this case hard clipping takes over.
+  - "Saturated": a saturator (soft clipper) keeps the output within +/-12V.
+  - "Hard clipped": the output is simply clipped at +/-12V.
+  - "None": no scaling or limiting is applied to the output, ignoring the voltage standards.  This was how XCO always behaved prior to version 2.*.41.  Older patches should restore this mode if affected by the addition of these options.
+
 _Polyphony:_ <a href="#polyphony">polyphonic</a>, with channels defined by the V/OCT input.
 
 _When <a href="#bypassing">bypassed</a>:_ no output.
@@ -259,10 +265,10 @@ A general-purpose filter with a selectable lowpass, highpass, bandpass or bandre
   - Smoothly modulatable bandwidth in bandpass and bandreject modes.
   - Very accurate V/OCT tracking.
 
-The large knob sets the filter's base cutoff frequency (for lowpass and highpass modes) or center frequency (for bandpass and bandreject).  There are three CV inputs that affect the cutoff; each input is converted to a HZ value and added to the base value set by the knob:
+The large knob sets the filter's base cutoff frequency (for lowpass and highpass modes) or center frequency (for bandpass and bandreject).  There are three CV inputs that affect the cutoff, in this order:
   - CV: a general, linear input expecting bipolar +/-5V signals. The input is attenuverted by the CV knob.
-  - V/OCT: an input here is interpreted as a pitch CV.  Use this and set the main knob to 0HZ for accurate key tracking.
-  - FM: an exponential FM input; the input here is attenuated by the FM knob, then added to the V/OCT input (which normals to 0V) before being converted to HZ.
+  - V/OCT: an input here is interpreted as a pitch CV; if connected, the input voltage is interpreted as a frequency and added to the cutoff.  Use this and set the main knob to 0HZ for accurate key tracking.
+  - FM: an exponential FM input; the input here is attenuated by the FM knob.  It is implemented by converting the cutoff to a V/Octave pitch CV, adding the attenuated FM signal to that, and converting back to frequency.
 
 The RES/BW knob has two functions, depending on mode:
   - In lowpass and highpass modes, it controls the resonance of the filter at the cutoff frequency.  The filter does not self-resonate.

plugin.json

@@ -1,7 +1,7 @@
 {
   "slug": "Bogaudio",
   "name": "Bogaudio",
-  "version": "2.0.40",
+  "version": "2.1.41",
   "license": "GPL-3.0-or-later",
   "brand": "Bogaudio",
   "author": "Matt Demanett",