CHANGELOG.md

Sapphire modules for VCV Rack 2 — change log

Date	Version	Notes
7 Nov 2024	2.5.3	Fixed inaccurate frequency tuning of Pop when CHAOS=0. Also made Pop's SPEED control voltage operate as V/OCT when the attenuverter is set to +100%.
25 Oct 2024	2.5.2	Added new filter module Sauce. This uses the same filter algorithm as Gravy but with an interface optimized for general polyphonic use. Gravy now includes an automatic gain control (AGC) limiter in the right-click menu. The limiter is OFF by default, but can be adjusted to the range 5V..50V. This can be helpful when the output gets hot due to high resonance settings. Added a channel count display that shows 1..16 in Pop, Hiss, and SplitAddMerge. This allows you to know the number of output channels just by looking at the panel.
11 Sep 2024	2.5.1	Added new module Gravy: a stereo filter with frequency and resonance controls. Galaxy and Gravy support polyphonic stereo input and output.
6 Sep 2024	2.5.0	Split/Add/Merge now allows selecting any output channel count from 1..16. Before, the channel count was always 3. The default is still 3, for backward compatibility. Each Sapphire module now links to its individual documentation page instead of the Sapphire table of contents. Moots now allows you to toggle the anti-ramping option on each of the 5 groups by right-clicking on the button for that group. You can still right-click the panel and toggle the option that way, although I believe most people will prefer the new method. Moots also draws a "ramp" symbol on top of a button when anti-click is enabled. This allows you to see at a glance how all the buttons are configured, without clicking on anything. Added a voltage-flip option for X, Y, Z outputs on Frolic, Glee, Pivot, and Rotini.
23 Aug 2024	2.4.9	New module: Pop that generates trigger pulses that match the statistical timing of radioactive decay. New module: Split/Add/Merge to make working with 2- or 3-channel signals use less real estate in a patch. Panels with XYZP port groups now have a hexagon around the P port to make it easier to spot which one is 3D/polyphonic.
20 Jul 2024	2.4.8	New module: Pivot for re-orienting a 3D vector. This is another chaos toy. Rotini: added missing help text for ports. Glee now has 4 different chaos modes that you can select from the context menu. Glee and Frolic now have a Turbo Mode that uses more CPU but allows the oscillators to go up to 32 times faster than before (+5 added to SPEED knob).
8 Jul 2024	2.4.7	New module: Rotini. It helps create more interesting chaotic 3D vector signals for fun CV. Galaxy: added option for polyphonic stereo input to a single input port (L or R). Galaxy: auto-reset if output becomes non-finite or goes outside 100 V absolute value. Tube Unit: [Issue #56](#56) - added support for low-sensitivity attenuverters.
11 Jun 2024	2.4.6	Added new module: Galaxy.
11 May 2024	2.4.5	The following Sapphire modules already supported low-sensitivity attenuverters: Elastika, Nucleus, Polynucleus. Now, in addition to being able to right-click and toggle each attenuverter's sensitivity one at a time, you can right-click on any of the above modules to toggle all of its attenuverters.
22 Apr 2024	2.4.4	Nucleus and Polynucleus: added a right-click slider for adjusting the DC reject filter's corner frequency. Before this change, both modules had a fixed corner frequency of 30 Hz. This is still the default frequency, but now the right-click menu allows you to change the corner frequency to any value from 20 Hz to 400 Hz. Polynucleus: added a CLEAR button that resets the simulation, just like the right-click menu option does. Moots: Fixed cosmetic issue #45: when the user changes from gate mode to trigger mode, the text GATE on the panel now changes to TRIGGER.
18 Mar 2024	2.4.3	Moots: added right-click menu option to toggle between the control port using a gate signal (default) or a trigger-toggle signal.
3 Mar 2024	2.4.2	Added a low sensitivity option to attenuverter knobs. Sometimes the adjustments were so tiny to get a desired affect that it was awkward to get it right. Low sensitivity mode allows you to more easily explore those delicate parameters! Tricorder's animation is much smoother now. I compensated for jitter caused by VCV Rack calling my animation update function at irregular time intervals. Tricorder now allows you to manually adjust its rotation speed using the right-click context menu. You can select any rotation speed from 0.01 RPM to 100 RPM. Tricorder: Fixed [Issue #40](#40): now you can right-click on the display area and the context menu will appear. Before, you had to click on the top of the panel to get the context menu to appear.
22 Feb 2024	2.4.1	Added new module Polynucleus. This module is the same as Nucleus, only with 3-channel polyphonic ports instead of triplets of monophonic ports. Added new module Tout. This module can be placed to the right of a Tricoder to provide the vector that Tricorder is graphing as voltages on output ports. Tout is the inverse of Tin. Added new module Hiss for generating unbiased vectors in an N-dimensional space. Nucleus issue #30: watch out for infinite/NAN input. If it happens, reset the internal state and keep going. Added a "reset simulation" command in the right-click menu that allows you to manually bring the particles to a halt. This can be handy when the simulation gets out of control in a way that does not trigger the NAN auto-reset mentioned above. Elastika, Nucleus, and Tube Unit now auto-reset if infinite/NAN output is detected, and indicate the problem by turning the OUTPUT level knob bright pink for 1 second, every time it happens. Frolic and Glee now provide an additional polyphonic output with the entire vector represented as a 3-channel port. Tin now provides an additional polyphonic input to feed in a 3-channel (X, Y, Z) input vector. Tin and Tout now have a LEVEL knob, attenuverter, and CV input. This allows them to adjust the magnitude of vectors that flow through them.
7 Feb 2024	2.4.0	Added a new module: Nucleus. Fixed issues where Elastika and Tube Unit did not persist AGC level or DC reject frequency. They were being reset to their default values every time a patch was loaded. Tricorder: the numeric display now includes a triangle that points up or down, depending on whether the value is increasing or decreasing. Tricorder: when first connected to a constant 0V input, immediately refresh the coordinate axes. Before this change, the display area stayed blank until the input voltage changed by more than 0.1V. This was confusing, because it looked like there is no input signal! Tricorder: Added a new command button `[]` to clear the path and start over with a fresh display. Tin: added a trigger input port that clears the Tricorder display. The modules that include an Automatic Gain Limiter (Elastika, Tube Unit, Nucleus) now allow the limiter to go as low as 1V, and the default has been changed from 8.5V to 4V. Backward compatibility is preserved: existing patches will still contain their original AGC settings, without any behavior changes.
19 Nov 2023	2.3.1	Added bonus module Glee, a chaotic oscillator similar to Frolic but with a different 3D shape.
22 Oct 2023	2.3.0	Added new modules: Frolic: a low frequency chaotic oscillator with 3 outputs Tricorder: a 3D animation scope designed for Frolic and Tin Tin: sends any (x, y, z) values from input ports into Tricorder
12 Mar 2023	2.2.2	Changes to Tube Unit: Fixed display issues when there were multiple Tube Units in a patch, some with audio connected, others without. The yellow pathway around ROOT, DECAY, and ANGLE would sometimes be incorrectly shown/hidden. Added VENT/SEAL toggle menu option. Allows inverting the logic for the gate input. Added more descriptive hover-text for attenuverter knobs and CV input ports.
3 Mar 2023	2.2.1	Initial release of Sapphire Tube Unit.
18 Nov 2022	2.1.3	Fixed a bug in the output level knob. It was incorrectly scaling the output level far too sensitively. Now the decibel value displayed by the knob exactly matches its actual amplification. Elastika now includes an adjustable output limiter. Before this was added, output levels could get VERY hot. The limiter mostly prevents the output amplitude from exceeding an adjustable level, although there can be brief transients after sudden changes. By default, the limiter is enabled and set to a threshold of 8.5V. Using Elastika's right-click context menu, you can adjust the limiter threshold anywhere from 5V to 10V. If you slide the limiter all the way to the right, it turns the limiter completely off. Disabling the limiter like this can result in extreme output voltages in some cases, but it could make sense for patches where Elastika's output is attenuated externally.
13 Nov 2022	2.1.2	Improvements based on community feedback. Added bypass support for Elastika and Moots. Sum polyphonic inputs (audio and CV) in Elastika and Moots. Elastika checks for NAN outputs every quarter of a second and auto-recovers if found. (One user reported NAN output, but was not able to reproduce it, and I haven't see it happen yet.) Added right-click menu slider in Elastika to adjust output DC reject corner frequency. Default is 20 Hz, but can go up to 400 Hz. Prevent randomization of Elastika's input and output level knobs.
8 Nov 2022	2.1.1	Initial release of Sapphire Elastika.
30 Aug 2022	2.0.1	Made the following fixes/improvements to Sapphire Moots: Issue #1: When a controller is turned off, no longer make the push-button completely dark. Instead, give it a very dim glow, so that it can still be seen when the room brightness is very dark. Issue #2: Added 5 options to the context menu, one for each controller, to enable/distable anti-click ramping. When enabled, the controller applies a 2.5 millisecond linear ramp before unplugging a cable and after plugging it back in. When disabled, the cable is plugged/unplugged instantly, which is usually a better choice for control voltages. Issue #3: Debounce gate voltages using hysteresis. Turn a controller on when its gate reaches 1.0V or higher. Turn it back off when the gate descends to 0.1V or lower.
19 Aug 2022	2.0.0	Initial release of Sapphire Moots.