update to v2.6.2

README.md

@@ -1,7 +1,7 @@
-# SickoCV v2.6.1
+# SickoCV v2.6.2
 VCV Rack plugin modules
 
-![SickoCV modules 2 6 0](https://github.com/sickozell/SickoCV/assets/80784296/9b13e8bb-d7d9-4614-9993-07dbd839ecc9)
+![SickoCV modules 2 6 2](https://github.com/sickozell/SickoCV/assets/80784296/29c113e7-2e4b-4046-979c-20932d159923)
 
 ## table of contents
 - [Common modules behavior](#common-modules-behavior)
@@ -17,6 +17,7 @@ VCV Rack plugin modules
 - [CV router / CV switcher](#cvrouter--cvswitcher)
 - [drummer / drummer4 / drummer4+](#drummer--drummer4--drummer4)
 - [drumPlayer / drumPlayer+ / drumPlayerXtra](#drumplayer--drumplayer--drumplayerxtra)
+- [holder / holder Compact / holder8](#holder--holder-compact--holder8)
 - [parking](#parking)
 - [shifter](#shifter)
 - [sickoAmp](#sickoamp)
@@ -55,6 +56,8 @@ if it's used as a fixed pitch adder (without input CV connection) maybe it's use
 otherwise, if the knob is used as attenuverter with a CV input connected, it can be set to 0v as usual or to +10v to quickly get the full CV voltage.
 - **Reset All Knobs to Default**. This resets all knobs value to selected default setting.
 
+[back to index](#table-of-contents)
+
 ## bGates
 ### 8 buffered gates and triggers
 #### - DESCRIPTION
@@ -79,6 +82,8 @@ Pressing RSTALL button or triggering RESETALL input will immediately set all the
 - Initialize On Start: discards previous module state on VCV restart
 - Disable Unarm: this disables unarm feature
 
+[back to index](#table-of-contents)
+
 ## blender
 ### Polyphonic stereo crossfade mixer with double modulation
 #### - DESCRIPTION
@@ -106,6 +111,8 @@ Modulation is added to the MIX knob.
 **MOD2 section**  
 MOD2 can be used to add modulation to the MOD attenuverter knob in MOD section, the rules are the same.
 
+[back to index](#table-of-contents)
+
 ## blender8
 ### 8 single crossfade mixers with modulation
 #### - DESCRIPTION
@@ -121,6 +128,8 @@ Audio rate modulations are allowed.
 Only the IN2 input signal can be phase inverted.  
 If a CV input is connected for modulation, CV sets the mix percentage and the MIX knob becomes the CV attenuverter.
 
+[back to index](#table-of-contents)
+
 ## bToggler / bToggler Compact
 ### Buffered stereo signal toggle switch router, with VCA and ASR envelope generator, in regular and compact form factor
 #### - DESCRIPTION
@@ -154,6 +163,8 @@ Polyphony on L/(R) inputs is replicated on outs.
 - Disable Unarm: this disables unarm feature
 - Trigger on Gate Out: this option substitutes Gate Output with a 1ms trigger whenever a clock is detected when armed
 
+[back to index](#table-of-contents)
+
 ## bToggler8
 ### 8 buffered toggle switch signal router
 #### - DESCRIPTION
@@ -197,6 +208,8 @@ Here below is one example of bToggler8 usage. When buttons are pressed on PULSES
 ![bToggler8 example](https://user-images.githubusercontent.com/80784296/204083532-db145211-1f61-45cd-9c4d-572fc243d7d3.JPG)  
 [Download example](./examples/bToggler8%20example.vcvs?raw=true) (right-click -> save link as)
 
+[back to index](#table-of-contents)
+
 ## bToggler8+
 ### 8 buffered toggle switch router, plus warnings to use with led midi controllers
 #### - DESCRIPTION
@@ -232,6 +245,8 @@ Here below is one example of bToggler+ usage. The MIDI>GATE module is connected
 ![bToggler8plus example](https://user-images.githubusercontent.com/80784296/204083544-34ecf3b0-0d12-4965-bd72-f3bb85339551.JPG)  
 [Download example](./examples/bToggler8plus%20example.vcvs?raw=true) (right-click -> save link as)
 
+[back to index](#table-of-contents)
+
 ## calcs
 ### Calculates sums, differences, multiplications, divisions and averages of 3 CV inputs
 
@@ -242,6 +257,8 @@ A, B and C are the inputs. The output tables provide simple math calculations an
 
 U/B (Unipolar/Bipolar) switch clamps the outputs to 0/10V or ±5v.
 
+[back to index](#table-of-contents)
+
 ## clocker
 ### Clock generator with 4 dividers/multipliers and audio metronome
 
@@ -291,6 +308,8 @@ When ticked, BAR pulses on the BAR output are duplicated on the BEAT output.
 - **On Stop**  
 This submenu is the same as the previous one but when the Run Button is switched off.
 
+[back to index](#table-of-contents)
+
 ## CvRouter / CvSwitcher
 ### 1>2 and 2>1 voltage controlled switch  
 
@@ -304,6 +323,8 @@ The FADE knob with its added CV input, will crossfade up to 10s the INs or OUTs.
 
 The default value of the "THR" knob is +1v.
 
+[back to index](#table-of-contents)
+
 ## drummer / drummer4 / drummer4+
 ### Accent and choke utility for drum modules lacking these features
 
@@ -341,6 +362,8 @@ Example of Drummer4 module usage:
 - **Drummer4+ note:**  
 Drummer4+ it's the same of Drummer4. It only adds attenuverted CV inputs to parameter knobs.
 
+[back to index](#table-of-contents)
+
 ## drumPlayer / drumPlayer+ / drumPlayerXtra
 ### 4 channel Drum Sample Player with accent and choke functionality
 
@@ -416,6 +439,53 @@ Right clicking on led area (drumPlayer) or display area (drumPlayer+ drumPlayerX
 - Light Box color (if Light Boxes option is enabled in the general context menu, a predefined color or a custom one can be set here)
 - Light Box Fade (Fade time of Light Boxes is set here: Slow (0.5s), Normal (0.25s), Fast (0.1s)
 
+[back to index](#table-of-contents)
+
+## holder / holder Compact / holder8
+### Sample & Hold or Track & Hold with noise generator, probability and range
+
+![holder](https://github.com/sickozell/SickoCV/assets/80784296/cbcc05b1-f874-429b-8856-f191381aa2d0)
+
+#### - INSTRUCTIONS
+S&H / T&H switch changes the mode between Sample & Hold and Track & Hold
+
+Sample & Hold: a trigger on TRIG input samples the last received signal on IN input that is sent to the OUT  
+Track & Hold: until the gate on GATE input is HIGH the IN signal is sent to the OUT. The last received signal is sent to the OUT until the GATE is LOW.
+
+PROB knob, with its modulation input and attenuverter, sets the probability to sample the input signal.  
+SCL knob, with its modulation input and attenuverter, rescale the output signal.  
+OFS knob, with its modulation input and attenuverter, offsets the output signal.  
+
+If IN input is not connected a ±5v Noise Generator is taken as input source.
+
+OUT output is feeded with sampled or tracked signal.  
+TRIG output sends a trigger when sample occurs. If Track & Hold is selected, it sends a trigger on tracking start and/or end, or a gate depending by the options ticked on context menu.
+
+Holder can be used as a simple white noise generator if in T&H mode with Sample on HIGH gate option ticked. There's a specific function in the context menu to achieve this setting with one click.
+
+holder8 is composed of 8 independent holder modules without attenuators and trig output.
+
+#### CONTEXT MENU
+**White Noise Type**  
+There are two types of white noise generator.  
+- FULL generates random ±5v voltages.
+- CENTERED generates random ±5v voltages but the weight is more centered, and occasionally may exceed the range.
+
+Comparison:  
+![Holder_b](https://github.com/sickozell/SickoCV/assets/80784296/72ed6cb8-7372-4c4d-9670-c5d4de5d1c5b)
+
+**Track & Hold options**
+
+- Sample on HIGH Gate: this inverts standard track&hold usage, on LOW gate the signal passes and on HIGH gate the signal is held.
+- Trig on Start: sends a trigger on TRG out when the signal is sampled.
+- Trig on End: sends a trigger on TRG out when the signal stops being sampled.
+- Gate Out instead Trig: sends a HIGH gate on TRG out when the signal is sampled.
+
+**Noise Generator preset**  
+This function sets the module to Track & Hold mode, sample on HIGH gate, scale on 100% and offset to 0v, just to output white noise if trig/gate input is not connected or not triggered.
+
+[back to index](#table-of-contents)
+
 ## parking
 ### Set of unconnected inputs and outputs just to park unused cables
 
@@ -425,6 +495,8 @@ Right clicking on led area (drumPlayer) or display area (drumPlayer+ drumPlayerX
 This module doesn't do anything. It's just a place to connect temporarily unused cables to not forget to where they were wired.  
 It can also be used to connect other modules sockets when they need to be wired to obtain some functionality.
 
+[back to index](#table-of-contents)
+
 ## shifter
 ### 64 selectable stages shift register
 #### - DESCRIPTION
@@ -446,6 +518,8 @@ The TRIG DELAY knob can be used to delay the TRIG INPUT up to 5 samples, because
 ![shifter example](https://user-images.githubusercontent.com/80784296/212531455-776e3110-78ef-4bec-a3f8-64180fe4ca53.JPG)  
 [Download example](./examples/shifter%20example.vcvs?raw=true) (right-click -> save link as)
 
+[back to index](#table-of-contents)
+
 ## sickoAmp
 ### Polyphonic stereo VCA up to 200% with limiter
 
@@ -461,6 +535,7 @@ If both inputs are used with polyphony, channels on the Right output replicate t
 #### Context Menu
 - Polyphonic OUTs. When this option is enabled the outputs reflect input polyphony. Otherwise polyphonic inputs are mixed in one monophonic out.
 
+[back to index](#table-of-contents)
 
 ## sickoLooper3 / sickoLooper5
 ### 3/5 track loopers with builtin clock generator, click and meter.
@@ -472,9 +547,11 @@ sickoLooper is inspired by hardware looper devices with most of their features i
 #### - MANUALS
 Due to the complexity of these modules, a PDF user manual has been written
 
-[Download ENGLISH user manual](./docs/sickoLooper%20user%20manual%20%5BEN%5D.pdf?raw=true) (right-click -> save link as)
+Download [ENGLISH user manual](./docs/sickoLooper%20user%20manual%20%5BEN%5D.pdf?raw=true)
+
+Download [manuale utente ITALIANO](./docs/sickoLooper%20manuale%20utente%20%5BIT%5D.pdf?raw=true)
 
-[Download manuale utente ITALIANO](./docs/sickoLooper%20manuale%20utente%20%5BIT%5D.pdf?raw=true) (right-click -> save link as)
+[back to index](#table-of-contents)
 
 ## sickoPlayer
 ### wav sample player
@@ -584,6 +661,8 @@ There are some factory presets stored in the context menu for common using setti
 One-cycle waveforms can be used in GATE mode with LOOP mode enabled.  
 Be sure to recall relative preset or disable PhaseScan, adjust Cue and Loop START to 0% and Cue/Loop END to 100% and enable loop button.  
 
+[back to index](#table-of-contents)
+
 ## sickoSampler
 ### wav sample player and recorder
 
@@ -650,6 +729,8 @@ Please refer to sickoPlayer for context menu, in sickoSampler following options
 - UCE/ULE updates also Start: if UCE and/or ULE button are on, when recording is stopped also Cue Start and/or Loop Start cursors are reset to the recording start position (if recording is reversed it updates Cue/Loop End cursor).
 - Crossfade while Rec Fading: If overdub is not activated this option crossfades between previous and current recording only during fading in/out recording time, accordingly to the FD knob.
 
+[back to index](#table-of-contents)
+
 ## sickoSampler2
 ### wav sample player and recorder
 
@@ -688,6 +769,8 @@ Please note that extreme settings can however alter pitch a little or obtain a b
 **Context Menu**  
 'Auto Monitor Off' option is activated by default and it stops monitoring input after a recording is stopped.
 
+[back to index](#table-of-contents)
+
 ## switcher / switcherSt
 ### 2>1 switch, 1>2 router, 2 signal swapper, mute, flip flop, toggle gate
 #### - DESCRIPTION
@@ -749,6 +832,8 @@ CV input is added to Fade knob value and the sum will be clamped in the range of
 - On SwitcherSt module the function type is detected on Left channel sockets, so don't use Right channels without Left ones
 - Polyphony on signal inputs is replicated on outs
 
+[back to index](#table-of-contents)
+
 ## toggler / toggler Compact
 ### Stereo signal toggle switch router, with VCA and ASR envelope generator, in regular and compact form factor
 #### - DESCRIPTION
@@ -790,6 +875,8 @@ These behaviors are more understandable connecting a scope on the output.
 #### Context Menu
 - Initialize On Start: discards previous module state on VCV restart
 
+[back to index](#table-of-contents)
+
 ## wavetabler
 ### wavetable sample player
 
@@ -818,9 +905,13 @@ Master knob, with its attenuverted CVinput, sets the output volume from 0 to 200
 #### Context Menu
 Please refer to sickoPlayer documentation.
 
+[back to index](#table-of-contents)
+
 ## CREDITS
 The Component Library graphics for these modules are copyright © VCV and licensed under [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/)  
 
 Thanks to [Squinkylabs](https://github.com/squinkylabs), [Firo Lightfog](https://github.com/firolightfog) and [AuxMux](https://instagram.com/aux.mux) for help and testings, and all the [Vcv community](https://community.vcvrack.com)  
 Thanks to [Omri Cohen](https://omricohen-music.com/) for support  
 Thanks to [Clément Foulc](https://github.com/cfoulc) for creating [cfPlayer](https://library.vcvrack.com/cf/PLAYER), which was the basis and inspiration for writing all the sampler modules in this collection  
+
+[back to index](#table-of-contents)

changelog.md

@@ -1,4 +1,7 @@
-### 2.6.1 (2023-12-18)
+### 2.6.2 (2023-12-26)
+- added holder, holder Compact and holder8 modules  
+
+### 2.6.1 (2023-12-17)
 - sickoLooper: added dark green color to the display bar when the loop is still playing even if its recording is finished  
 fixed a bug on 'stop all' trig input  
 - clocker: fixed a bug on swing control

extra/crossCompiler.md

@@ -1,11 +1,11 @@
-git tag v2.6.1 -m "create v2.6.1"  
+git tag v2.6.2-beta5 -m "create v2.6.2-beta5"  
 git push origin --tags  
 
 delete local tag  
-git tag -d v2.6.1-beta
+git tag -d v2.6.2-beta
 
 delete remote
-git push --delete origin v2.6.1-beta
+git push --delete origin v2.6.2-beta
 
 
 ### How to build a VCVRack plugin with Github Action

plugin.json

@@ -1,7 +1,7 @@
 {
   "slug": "SickoCV",
   "name": "SickoCV",
-  "version": "2.6.1",
+  "version": "2.6.2",
   "license": "GPL-3.0-or-later",
   "brand": "Sickozell",
   "author": "Sickozell",
@@ -181,6 +181,37 @@
         "Quad"
       ]
     },
+    {
+      "slug": "Holder",
+      "name": "holder",
+      "description": "Sample & Hold or Track & Hold with noise generator, probability and range",
+      "tags": [
+        "Sample and hold",
+        "Noise",
+        "Polyphonic"
+      ]
+    },
+    {
+      "slug": "HolderCompact",
+      "name": "holder Compact",
+      "description": "Sample & Hold or Track & Hold with noise generator, probability and range in a compact form factor",
+      "tags": [
+        "Sample and hold",
+        "Noise",
+        "Polyphonic"
+      ]
+    },
+    {
+      "slug": "Holder8",
+      "name": "holder8",
+      "description": "8 Sample & Hold or Track & Hold with with noise generator, probability and range",
+      "tags": [
+        "Sample and hold",
+        "Noise",
+        "Quad",
+        "Polyphonic"
+      ]
+    },
     {
       "slug": "Parking",
       "name": "parking",