Waldorf Quantum/Iridium: apply the modulation and envelope laws of the firmware 4.0.6, convert the filter LFO, the glide and the polyphony

documentation/CHANGELOG.md

@@ -119,8 +119,16 @@
   * Fixed: The cutoff of the filter was written with the normalized parameter value as its display text, so the device listed a patch with a cutoff of e.g. 61.7 Hz as '0.2592 Hz'. A cutoff at the top of the range of the model (20,000 Hz) also wrote a parameter value slightly above the 1.0 the device expects; it is now limited to the 19,912.2 Hz of the device.
   * New: The volume and the pan of the whole timbre (TBPIVolume, an attenuation in dB, and TBPIPan, -63..63) are read and applied on top of the settings of the partials; a timbre which the editor turned down - by up to 16 dB in the Studio G Dallas library - was converted at full level.
 * Waldorf Quantum/Iridium
+  * New: The 'Use a second layer' option became 'Maximum number of layers' with 1 to 4 layers. With 3 or 4 layers a source with more than 6 groups is written with up to 9 or 12 multi-samples in the layout of the MK2 generation: the layer count 2, the format version 15 and always four stored layers, of which the unused ones are switched off, exactly as the Iridium MK2 stores its own patches (304 files of the corpus). The loader of the device clears the file offsets of the layers 3 and 4 in files up to the version 14, which is why four layers need the version 15; the first generation of the instruments holds two layers (its manuals) and cannot play such a file. Verified on an Iridium MK2 (OS 4.0.6): a written 4-layer patch with one sample pitch per layer plays all four pitches, a 3-layer patch with its switched-off fourth layer plays its three. Only as many layers as the groups need are used, so a source with up to 6 groups is still written as the 2-layer patch which every instrument of the family plays. The samples of all later layers are named in the first layer for the importer of the device. A setting of the old option is taken over.
   * New: Round robins are written into one sample map. Entries of a map which overlap in key and velocity alternate on successive notes on the device, which is exactly a round robin; the zones of a round robin were spread over separate oscillators as if they were stacked layers, so all of them sounded at once on every note. When reading, overlapping entries of a map become a round robin. The device has no random selection, so random zones alternate as well.
-  * New: A monophonic source is written with the mono mode of the patch (PolyMonoMode), which is read back as well.
+  * New: A monophonic source is written with the mono mode of the patch (PolyMonoMode), which is read back as well. A source with a polyphony of 1 is written with it too, and a patch in the mono mode is read with a polyphony of 1.
+  * New: The modulation of the filter cutoff by a low frequency oscillator is read and written, in the matrix slot 6 with LFO 3 on the destination Filter1 Cutoff. The device adds the amount to the cutoff without squaring it, and the full amount covers the whole range of the filter, 135 semitones (Iridium MK2 firmware 4.0.6). Verified on an Iridium MK2: +8.89 % moves the cutoff by an octave.
+  * New: The portamento of a source is written as the glide of the patch and read back. The device glides for 2 x GlideRate^2 seconds, the same time for every interval (Iridium MK2 firmware 4.0.6), which is what the portamento time of a source means; a legato source uses the glide type Legato. Verified on an Iridium MK2: a glide of 1 second takes 1.000 seconds over 2 and over 4 semitones.
+  * New: A key tracking other than 100 % which all key-tracked zones of a group share is written as the key tracking of their oscillator instead of 100 %.
+  * Fixed: Pitch envelopes and vibratos were written far too shallow and read far too deep. The device squares the amount of a matrix slot which modulates a pitch before it applies it, keeping its sign, and multiplies the result with 24 semitones (Iridium MK2 firmware 4.0.6): an amount of 50 % raises the pitch by 6 semitones, not by 12, and the amount which was written for a vibrato of 50 cents plays one of about 1 cent. The amounts are now written and read with the law of the device. The vibratos which the factory patches put on the modulation wheel, 11 to 20 %, are 29 to 96 cents with it. Verified on an Iridium MK2 (OS 4.0.6): an oscillator modulated at +50 % plays 6.00 semitones above an unmodulated one, and a converted vibrato of 50 cents swings +/-49.97 cents, where the previous conversion swings +/-1.04 cents.
+  * Fixed: Every attack, decay and release was played 60 ms shorter than the source asked for, and a stage shorter than 60 ms was written as instant. The sound engine plays the value x of such a stage as 60 x 10^(3 (x - 1)) - 0.06 seconds, while the display of the device shows 60 x 10^(3 (x - 1)) - 0.001 seconds - the law which was used. Measured on an Iridium MK2 with OS 4.0.6: stages written for 0.07, 0.1, 0.25, 0.5, 1 and 2 seconds took 0.011, 0.041, 0.190, 0.441, 0.940 and 1.940 seconds, alike for the attack, the decay and the release. The times are now written and read with the law of the sound engine. The shortest amplitude attack and release which avoid a click stay at the 10 ms which the device played before.
+  * Fixed: The decay of a pitch envelope was lost when the source did not set a start level. Such an envelope was written like one which starts at a level: no attack, and the attack time of the source as its decay. An SFZ pitch drop over 0.5 seconds arrived as an instant blip. Only an envelope with a start level above 0 is written that way now. Verified on an Iridium MK2: the converted pitch drop starts every note an octave high and slides down in a straight line, where the previous conversion plays the note at its pitch from the start.
+  * Fixed: The tremolo of a patch written by an older firmware was not found, and a slot which modulates another destination with the index 117 could be read as a tremolo. The list of matrix destinations grew with the firmware - the VCA is 107 up to the format version 13, 108 in version 14 and 117 in version 15 - and the device resolves a destination by the name in the hint of the parameter (Iridium MK2 firmware 4.0.6). Destinations are now read by their name, by the index of the format version if the hint is empty, and written with the index of the written version.
   * New: The key window of an oscillator (Osc{i}MinNote/MaxNote) is applied when reading: a zone outside of it is silent on the device and is dropped, a zone across its edge is cut at it.
   * New: The volume, the gain and the panning of a layer (LayerVolume, LayerGain, LayerPan) are applied to the zones of the layer when reading. A layer at a LayerVolume of 0.81 - the value of one of the factory patches - is 3.7 dB quieter than its oscillators say. The laws come from the firmware of the Iridium MK2: LayerVolume follows the law of the oscillator volume (40 x log10), LayerGain adds 0 to 24 dB.
   * New: A sample map with more than 1024 entries is reported. The device stores at most 1024 entries per map and drops every further one with the error 'Number of entries in sample map exceeded' (Iridium MK2 firmware 4.0.6).