-
Notifications
You must be signed in to change notification settings - Fork 13
Ratchet
Adds retriggering/ratchets to the given clip based on a list of values, another clip, or itself as the source. The ratchets produced can be scaled and shaped in various ways.
Aliases for parameters are listed in italic.
| Name | Description |
|---|---|
| <list of Number> | A list of values specifying the number of retriggers the current note will be split into. For instance, passing a list of 1 4 6 will keep the first note as is, the second note will be split in four, the third note will be split in six, after which it will cycle back around so that the fourth note will be kept as is, and so on. |
| ‑autoscale ‑auto |
When using another clip to control the ratcheting amount, this option controls whether the control sequence should be scaled so that the lowest note corresponds to the minimum ratchet value and the highest note corresponds to the maximum ratchet value. For instance, if the lowest note in the control clip is D3, and the highest note is F4, then D3 will yield the minimum ratchet amount of 1, while F4 will yield the maximum ratchet amount of 15 (F4 - D3 = 15). When this option is not specified, the default behaviour is that the ratchet range begins at the lowest note rounded down to the nearest octave boundary (i.e. C) and ends with the highest note rounded up to the nearest octave boundary. |
| ‑by Clip reference | Specifies a clip to be used to control the ratcheting. |
| ‑mode Velocity|Pitch | Specifies whether pitch or velocity should control the ratcheting. Only applicable when the ratcheting is controlled by another clip. |
| ‑shape Linear|EaseInOut|EaseIn|EaseOut | Controls the shaping of the produced ratchets. Linear means that all ratchets will get the same length, while EaseInOut will create longer ratchets at either end of the note, and longer ratchets in the middle. Experiment with the different shapes in additon to the strength parameter described below. |
| ‑strength Decimal number: 1.0 | Controls to what extent the shape parameter will affect the produced ratchets, from 0.0 (no effect) to 1.0 (full effect). |
| ‑velocitytostrength ‑veltostr |
If specified, the velocity of notes in the control clip controls the strength parameter dynamically. |
- rat
=a1 ratchet 1 4 6
This command applies ratcheting to clip a1, with a cycle of 1, 4, and 6 retriggers for each consecutive note.
=a1 rat 3 -by b1 -mode Velocity -autoscale
This command applies ratcheting to clip a1 based on the velocity values in clip b1, with autoscaling enabled to adjust the ratchet amount to the range of velocities in b1.
=a1 rat 2 -by b1 -mode Pitch -shape EaseInOut -strength 0.5
This command applies ratcheting to clip a1 based on the pitch values in clip b1, using the EaseInOut shape with a strength of 0.5.
=a1 rat 4 -by b1 -mode Velocity -autoscale -velocitytostrength
This command applies ratcheting to clip a1 based on the velocity values in clip b1, with autoscaling enabled and the velocity of notes in b1 controlling the strength parameter dynamically.