Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
mozaic_mutator [2020/08/10 16:22] – Using wrap to shorten the lines _ki | mozaic_mutator [2020/09/06 08:40] (current) – Added MutatoR link _ki | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Mozaic: MutatoR ====== | ====== Mozaic: MutatoR ====== | ||
{{tag> | {{tag> | ||
- | |||
- | <WRAP group> | ||
- | <WRAP center column 30 % round warning> | ||
- | **Work in Progress** | ||
- | \\ | ||
- | Documentation is complete \\ | ||
- | but script isn't published ! | ||
- | </ | ||
<WRAP group>< | <WRAP group>< | ||
- | MutatoR is a script | + | < |
+ | MutatoR is a script | ||
channels with 64 user-defined configurations organized in 4 banks. | channels with 64 user-defined configurations organized in 4 banks. | ||
+ | </ | ||
+ | <p style=" | ||
MutatorR can issue pattern based or random note drops, velocity changes, transpositions with scales and destination channel | MutatorR can issue pattern based or random note drops, velocity changes, transpositions with scales and destination channel | ||
routings independenly for each channel to transform the melodic and rhyhtmic qualities of the input material. | routings independenly for each channel to transform the melodic and rhyhtmic qualities of the input material. | ||
+ | </p> | ||
+ | <p style=" | ||
+ | Interactively switching between configurations makes it possible to arrange, transform and decompose the piece played by the midi sequencers & generator in a live jam fashion. | ||
+ | </p> | ||
+ | |||
+ | </ | ||
The script is based on the concepts of the [[https:// | The script is based on the concepts of the [[https:// | ||
Line 42: | Line 42: | ||
The diagram also visualizes MutatoRs note modifaction capabilities such as volume changes (ch 5), transpositions (ch 7), | The diagram also visualizes MutatoRs note modifaction capabilities such as volume changes (ch 5), transpositions (ch 7), | ||
random note drops (ch 8) or pattern gating (ch 10) - like an extended version of [[https:// | random note drops (ch 8) or pattern gating (ch 10) - like an extended version of [[https:// | ||
+ | </ | ||
- | \\ | ||
===== The Views ===== | ===== The Views ===== | ||
+ | <WRAP group>< | ||
There are three main views | There are three main views | ||
* The **[[# | * The **[[# | ||
Line 73: | Line 74: | ||
=== Channel Header === | === Channel Header === | ||
The channel mode is shown in the heading and in the colorization of the pad: | The channel mode is shown in the heading and in the colorization of the pad: | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Mode ^ Color ^Info ^ | ^ Mode ^ Color ^Info ^ | ||
| Thru | Unlit | Note data passes unmodified | | | Thru | Unlit | Note data passes unmodified | | ||
Line 85: | Line 86: | ||
=== Channel Mutation Summary === | === Channel Mutation Summary === | ||
The lower part of each pads label describes the modifications applied: | The lower part of each pads label describes the modifications applied: | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Line ^ Info ^ Format ^ | ^ Line ^ Info ^ Format ^ | ||
| Top | note drop probability \\ drop pattern info | **Drop** //percent// \\ //drop pattern id// //**/**// //beat division// < | | Top | note drop probability \\ drop pattern info | **Drop** //percent// \\ //drop pattern id// //**/**// //beat division// < | ||
Line 120: | Line 121: | ||
\\ | \\ | ||
===== CONFIG View ===== | ===== CONFIG View ===== | ||
+ | <WRAP group>< | ||
The config view allows to select the active configuration by pressing the corresponding pad. | The config view allows to select the active configuration by pressing the corresponding pad. | ||
{{mutator_config_banks.gif}} | {{mutator_config_banks.gif}} | ||
- | There are four banks of 16 configs each. Each bank uses different pad colors (lavender, violet, magenta and yellow). | + | There are four banks of 16 configs each. Each bank uses different pad colors (lavender, violet, magenta and yellow). |
- | The currently active configuration is highlighted with light-blue color (Config 1). \\ | + | The currently active configuration is highlighted with light-blue color (Config 1). |
Changing the bank only changes the display, it does not active a different config. | Changing the bank only changes the display, it does not active a different config. | ||
Line 165: | Line 167: | ||
* Double-tap SHIFT to change to [[#CHANNEL View]] | * Double-tap SHIFT to change to [[#CHANNEL View]] | ||
* Hold SHIFT and then tap a pad to enter config [[# | * Hold SHIFT and then tap a pad to enter config [[# | ||
+ | |||
+ | <WRAP group>< | ||
+ | Config changes takes place immediately, | ||
+ | No active notes are muted or changed. | ||
+ | </ | ||
+ | |||
+ | </ | ||
\\ | \\ | ||
===== EDITOR View ===== | ===== EDITOR View ===== | ||
- | The EDITOR Víew consists | + | <WRAP group>< |
+ | The EDITOR Víew is split into 10 sub pages all in 22 knobs layout, grouped into 4 categories: | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Category ^ Page ^ Info ^ | ^ Category ^ Page ^ Info ^ | ||
| [[#Channel Mode]] | 1 | Channel mode, output channel assignment and config name | | | [[#Channel Mode]] | 1 | Channel mode, output channel assignment and config name | | ||
Line 179: | Line 189: | ||
* Turn the EDIT knob to change between the ten editor sub pages | * Turn the EDIT knob to change between the ten editor sub pages | ||
* Double-tap the EDIT knob to change to next sub page | * Double-tap the EDIT knob to change to next sub page | ||
+ | </ | ||
| | ||
==== Channel Mode ==== | ==== Channel Mode ==== | ||
+ | <WRAP group>< | ||
The page allows to change the channel modes and channel re-routing and to setup the config name shown on the [[#CONFIG View]] pads. | The page allows to change the channel modes and channel re-routing and to setup the config name shown on the [[#CONFIG View]] pads. | ||
Line 189: | Line 201: | ||
The channel knobs determine the mode of a channel. Each of the channels can either be | The channel knobs determine the mode of a channel. Each of the channels can either be | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Channel Mode ^ Knob Position ^ Info ^ | ^ Channel Mode ^ Knob Position ^ Info ^ | ||
| routed thru unmodified | fully left | Allows to compare modifications vs original | | | routed thru unmodified | fully left | Allows to compare modifications vs original | | ||
Line 216: | Line 228: | ||
Channel Mode and output redirections are shown in the header of the [[#CHANNEL View]] pad label and determine the color of the respective Pad. | Channel Mode and output redirections are shown in the header of the [[#CHANNEL View]] pad label and determine the color of the respective Pad. | ||
- | <WRAP group>< | + | <WRAP group>< |
- | ^ Mode ^ Redirection | + | ^ Mode ^ Chan ^ Color ^ Format ^ |
- | | Thru | Any | None | //channel number// **Thru** | | + | | Thru | any | - | //input ch// **Thru** | |
- | | Apply | No | Green | //channel number// **Apply** | | + | | Apply | same | green | //input ch// **Apply** | |
- | | Apply | Yes | Green | //channel number// **Apply >>** // output | + | | Apply | other | green | //input ch// **Apply >>** // output |
- | | Mute | No | Red | //channel number// **Mute** | | + | | Mute | same | red | //input ch// **Mute** | |
- | | Mute | Yes | Red | //channel number// **Mute >>** // output | + | | Mute | other | red | //input ch// **Mute >>** // output |
</ | </ | ||
+ | </ | ||
==== Note Drop ==== | ==== Note Drop ==== | ||
+ | <WRAP group>< | ||
The note drop settings span over three sub pages. | The note drop settings span over three sub pages. | ||
{{mutator_note_drop.gif}} | {{mutator_note_drop.gif}} | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Sub Page ^ Info ^ | ^ Sub Page ^ Info ^ | ||
| Drop Probability | Configures the percentage of random note drops | | | Drop Probability | Configures the percentage of random note drops | | ||
Line 237: | Line 251: | ||
| Sneak-In Probability | Configures the percentage of note re-enabling during the dropped elements of the pattern | | | Sneak-In Probability | Configures the percentage of note re-enabling during the dropped elements of the pattern | | ||
</ | </ | ||
- | |||
=== How Note Drop and Patterns works === | === How Note Drop and Patterns works === | ||
- | The Note Drop feature only applies to the note-on midi event - it is either passed or dropped (muted). | + | The Note Drop feature only applies to the note-on midi event - it is either passed or dropped (muted). |
- | This causes the note to be completely suppressed until its corresponding note-off midi event, | + | This causes the note to be completely suppressed until its corresponding note-off midi event, |
which is then likewise suppressed to avoid confusing the sound generator. | which is then likewise suppressed to avoid confusing the sound generator. | ||
- | The default settings for all configs is to let all notes pass. \\ | + | The default settings for all configs is to let all notes pass. |
Tweaking just the knobs on the 'Drop Probability' | Tweaking just the knobs on the 'Drop Probability' | ||
- | To allow more control over the timing of note drops, the MutatoR script offers a pattern based note drop feature. | + | To allow more control over the timing of note drops, the MutatoR script offers a pattern based note drop feature. |
- | A pattern drop definition consists of either four or eight elements, each either 1 (pass) or 0 (drop) and a beat division | + | A pattern drop definition consists of either four or eight elements, each either 1 (pass) or 0 (drop) and a beat division |
ranging froom 1/1 to 1/16 specifiying the speed the pattern is stepped through . | ranging froom 1/1 to 1/16 specifiying the speed the pattern is stepped through . | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Knob Label ^ Pattern ^ Info ^ | ^ Knob Label ^ Pattern ^ Info ^ | ||
| p5 | 1111 | Pass all notes | | | p5 | 1111 | Pass all notes | | ||
Line 259: | Line 272: | ||
</ | </ | ||
- | <WRAP group>< | + | <WRAP group>< |
The pattern feature will not mute or shorten already sounding sustained notes and therefor not allow pattern gating like [[https:// | The pattern feature will not mute or shorten already sounding sustained notes and therefor not allow pattern gating like [[https:// | ||
+ | </ | ||
</ | </ | ||
\\ | \\ | ||
=== The Two Drop Probabilities === | === The Two Drop Probabilities === | ||
+ | <WRAP group>< | ||
The two probabilites of the note drop pages serve different purposes: | The two probabilites of the note drop pages serve different purposes: | ||
Line 277: | Line 292: | ||
This allows for various use cases: | This allows for various use cases: | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Mutation \\ Goal ^ Note \\ Drop ^ Pattern \\ & Div ^ Sneak \\ In ^ Info \\ . ^ | ^ Mutation \\ Goal ^ Note \\ Drop ^ Pattern \\ & Div ^ Sneak \\ In ^ Info \\ . ^ | ||
| Play every on-beat of a drum, but other hits only occasionaly | 0% | 1000/16 | 5% | Every forth 1/16 is played with a 100% chance, all other steps have 5% chance of playing | | | Play every on-beat of a drum, but other hits only occasionaly | 0% | 1000/16 | 5% | Every forth 1/16 is played with a 100% chance, all other steps have 5% chance of playing | | ||
| Drop 25% of notes of the 3rd quarter of a bar | 0% | 1101/4 | 75% | The 1 elements will not drop any notes, the 0 elements will drop 25% as 75% of the notes are re-enabled | | | Drop 25% of notes of the 3rd quarter of a bar | 0% | 1101/4 | 75% | The 1 elements will not drop any notes, the 0 elements will drop 25% as 75% of the notes are re-enabled | | ||
- | | < | + | | < |
+ | </ | ||
</ | </ | ||
| | ||
=== Pattern Editor === | === Pattern Editor === | ||
+ | <WRAP group>< | ||
The Drop-Pattern page allows to choose any 8-step pattern and to specify the speed the pad is stepped through. | The Drop-Pattern page allows to choose any 8-step pattern and to specify the speed the pad is stepped through. | ||
Line 293: | Line 310: | ||
The knob label uses underlining as a visual indicator, which part of the pattern definition is edited. | The knob label uses underlining as a visual indicator, which part of the pattern definition is edited. | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Double-Tap # ^ Info ^ | ^ Double-Tap # ^ Info ^ | ||
| none | Turning a channel knob for the first changes between off (fully left) and 15 four-element pattern | | | none | Turning a channel knob for the first changes between off (fully left) and 15 four-element pattern | | ||
Line 302: | Line 319: | ||
- | The channel knobs displayed the pattern as hexadecimal value due to label length reasons, | + | The channel knobs displayed the pattern as hexadecimal value due to label length reasons, |
- | but the corresponding 0+1 elements are shown in the pattern visualizer on the right hand side. \\ | + | but the corresponding 0+1 elements are shown in the pattern visualizer on the right hand side. |
The four element pattern still show a 2 byte hex with a dublicated value. | The four element pattern still show a 2 byte hex with a dublicated value. | ||
- | Channel knobs and pattern visualizer knobs work in paralell. | + | Channel knobs and pattern visualizer knobs work in paralell. |
Both can be used alternatively and mixed for pattern and step definition. | Both can be used alternatively and mixed for pattern and step definition. | ||
+ | </ | ||
| | ||
=== Pattern Visualizer === | === Pattern Visualizer === | ||
- | The Pattern visualizer starting with the 🟩 knob offers an alternative way of pattern editing. | + | <WRAP group>< |
+ | The Pattern visualizer starting with the 🟩 knob offers an alternative way of pattern editing. | ||
A 🟢 highlights the currently visualized channel. | A 🟢 highlights the currently visualized channel. | ||
- | When it hosts timeline is running, there is an additional marker showing the active element - this \\ | + | When it hosts timeline is running, there is an additional marker showing the active element - this |
helps a lot in finding the right pattern and step division speed. | helps a lot in finding the right pattern and step division speed. | ||
Line 331: | Line 350: | ||
| | ||
- | <WRAP group>< | + | <WRAP group>< |
The pattern-element knobs apply a custom gray-code like sequence, which makes it easier (than the hex order) to select musicaly relevant patterns : | The pattern-element knobs apply a custom gray-code like sequence, which makes it easier (than the hex order) to select musicaly relevant patterns : | ||
<WRAP indent column> | <WRAP indent column> | ||
Line 339: | Line 358: | ||
0111, 0011, 0001, 0000 | 0111, 0011, 0001, 0000 | ||
</ | </ | ||
+ | </ | ||
</ | </ | ||
| | ||
=== Summary Label === | === Summary Label === | ||
+ | <WRAP group>< | ||
Note Drop mutations of a channel are listed in the top line of the mutation summary on [[#CHANNEL View]] pad label. Pure drop mutations are shown as <wrap box> | Note Drop mutations of a channel are listed in the top line of the mutation summary on [[#CHANNEL View]] pad label. Pure drop mutations are shown as <wrap box> | ||
+ | </ | ||
| | ||
==== Note Velocity ==== | ==== Note Velocity ==== | ||
+ | <WRAP group>< | ||
The two velocity sub pages of the [[#EDITOR View]] allow to specify a static velocity offset and a random velocity humanization percentage: | The two velocity sub pages of the [[#EDITOR View]] allow to specify a static velocity offset and a random velocity humanization percentage: | ||
{{mutator_velocity.gif? | {{mutator_velocity.gif? | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Modification ^ Range ^ Info ^ | ^ Modification ^ Range ^ Info ^ | ||
| Velocity Offset | -64 to +64 | Offsets original note velocity | | | Velocity Offset | -64 to +64 | Offsets original note velocity | | ||
Line 370: | Line 392: | ||
| | ||
- | |||
=== Remark === | === Remark === | ||
- | <WRAP group>< | + | <WRAP group>< |
Be aware that some synth only use fixed velocities for their sounds, sometimes this depends on the sound preset used. | Be aware that some synth only use fixed velocities for their sounds, sometimes this depends on the sound preset used. | ||
In such cases, changing the note-on velocity won't change the volume of the produced sound. | In such cases, changing the note-on velocity won't change the volume of the produced sound. | ||
</ | </ | ||
+ | </ | ||
+ | |||
==== Note Transpose ==== | ==== Note Transpose ==== | ||
+ | <WRAP group>< | ||
The four tranposition sub pages of the [[#EDITOR View]] allow to apply a fixed or random note offset and to apply scale quantizations. | The four tranposition sub pages of the [[#EDITOR View]] allow to apply a fixed or random note offset and to apply scale quantizations. | ||
{{mutator_transpose.gif? | {{mutator_transpose.gif? | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Modification ^ Range ^ Info ^ | ^ Modification ^ Range ^ Info ^ | ||
| Transpose Offset | -24 to +24 | Offsets original note by semi tones | | | Transpose Offset | -24 to +24 | Offsets original note by semi tones | | ||
Line 406: | Line 430: | ||
- | <WRAP indent> | + | <WRAP indent> |
<wrap box>Tra 0|39%</ | <wrap box>Tra 0|39%</ | ||
<wrap box>Tra 0|55%</ | <wrap box>Tra 0|55%</ | ||
Line 418: | Line 442: | ||
Even when interactively tweaking the transpostions and scale quantization, | Even when interactively tweaking the transpostions and scale quantization, | ||
- | <WRAP group>< | + | <WRAP group>< |
If you don't want to apply scale quantization without tranposition, | If you don't want to apply scale quantization without tranposition, | ||
up and down range of zero semi-tones. | up and down range of zero semi-tones. | ||
</ | </ | ||
- | // | + | </WRAP>< |
- | // | + | |
- | + | \\ | |
===== SWAP/COPY View ===== | ===== SWAP/COPY View ===== | ||
+ | <WRAP group>< | ||
The SWAP/COPY view allows to rearrange and duplicate channel or config settings. | The SWAP/COPY view allows to rearrange and duplicate channel or config settings. | ||
Line 434: | Line 459: | ||
=== Entering the View === | === Entering the View === | ||
- | To enter this view from either [[#CHANNEL View]] or [[#CONFIG VIEW]], hold the SHIFT button and press the source pad to be swapped or copied. | + | To enter this view from either [[#CONFIG VIEW]] or [[#CHANNEL View]], hold the SHIFT button and press the source pad to be swapped or copied. |
The top labels change to indicate the new view, a swap/copy knob appears and the source pad will start to flash and show a label to cancel the SWAP/COPY View. After initiating the SWAP/COPY View, release the source pad and SHIFT button. | The top labels change to indicate the new view, a swap/copy knob appears and the source pad will start to flash and show a label to cancel the SWAP/COPY View. After initiating the SWAP/COPY View, release the source pad and SHIFT button. | ||
+ | |||
+ | <WRAP group>< | ||
+ | ^ View ^ Operation ^ Info ^ | ||
+ | | CONFIG View | Swap | Swap settings from the select config with another of the 64 configs | | ||
+ | | CONFIG View | Copy | Copy settings from the selected config to another of the 64 configs | | ||
+ | | CHANNEL View | Swap | Swap setttings of both channels for all 64 configs to allow re-configuration \\ of the midi channels send by the generators | | ||
+ | | CHANNEL View | Copy | Copy the selected settings to a different channel on any of the configs | | ||
+ | </ | ||
| | ||
- | === Mode Change === | + | === Swap/ |
There are different flash pattern for swap or copy mode. The mode is toggled by turning or double tapping the swap/copy knob, or by tapping the SHIFT button. | There are different flash pattern for swap or copy mode. The mode is toggled by turning or double tapping the swap/copy knob, or by tapping the SHIFT button. | ||
Line 445: | Line 478: | ||
=== Cancel === | === Cancel === | ||
Tap the flashing source pad to cancel the operation and to leave the view. | Tap the flashing source pad to cancel the operation and to leave the view. | ||
+ | |||
+ | | ||
+ | === Bank or Config Change === | ||
+ | If acting on configs the Bank knob can be used to select destinations on a different bank as the source. | ||
+ | |||
+ | If acting on channels and with the COPY operation selected, the Config knob can be used to change to a different config for destination selection. | ||
+ | |||
+ | Whe the source pad is not visible, all pads are flashing with a slow tempo to visualize SWAP/COPY mode. | ||
| | ||
=== Execute === | === Execute === | ||
- | Tap a different pad to select the destination for the operation. If acting on configs, the bank knob can be used to select destinations on a different bank as the source. | + | Tap a different pad to select the destination for the operation. |
After tapping a destination pad, the operation is executed and SWAP/COPY View is left. | After tapping a destination pad, the operation is executed and SWAP/COPY View is left. | ||
- | <WRAP group>< | + | <WRAP group>< |
- | If acting on channels, the swap or copy operation is applied to all configs. | + | Swapping channels allows to reconfigure the output channels of MutatoRs input midi generators without loosing the current settings. |
</ | </ | ||
Line 465: | Line 506: | ||
=== Knobs === | === Knobs === | ||
- | * In [[#CONFIG View]] the bank knob allows to select a destination config on a different bank | + | * In [[#CONFIG View]] the Bank knob allows to select a destination config on a different bank. Double-tap to change to next bank |
+ | * In [[#CHANNEL View]] the Config knob allows to select a destination channel in a different config. Double-tap to change back to the source config. | ||
* Turn the swap/copy knob (or double-tap) to toggle between swap and copy operation | * Turn the swap/copy knob (or double-tap) to toggle between swap and copy operation | ||
=== Shift Button === | === Shift Button === | ||
* Tap SHIFT to toggle between swap and copy operation | * Tap SHIFT to toggle between swap and copy operation | ||
+ | </ | ||
- | \\ | + | \\ |
===== HELP View ===== | ===== HELP View ===== | ||
+ | <WRAP group>< | ||
The help view displays the embedded short description, | The help view displays the embedded short description, | ||
Line 515: | Line 559: | ||
* Tap SHIFT to change to the last active view, either [[#CHANNEL VIEW]] or [[#CONFIG VIEW]]. | * Tap SHIFT to change to the last active view, either [[#CHANNEL VIEW]] or [[#CONFIG VIEW]]. | ||
* Double-tap SHIFT to change to the other main view. If you entered the HELP view from [[#CONFIG VIEW]], a double-tap on SHIFT will change to the [[#CHANNEL View]] | * Double-tap SHIFT to change to the other main view. If you entered the HELP view from [[#CONFIG VIEW]], a double-tap on SHIFT will change to the [[#CHANNEL View]] | ||
+ | </ | ||
\\ | \\ | ||
===== Automation ===== | ===== Automation ===== | ||
+ | <WRAP group>< | ||
MutatoR supports AU parameter automation: | MutatoR supports AU parameter automation: | ||
- | <WRAP group>< | + | <WRAP group>< |
^ Parameter ^ Info ^ | ^ Parameter ^ Info ^ | ||
| user 0 | Selects the current configuration from config 1 to config 64 | | | user 0 | Selects the current configuration from config 1 to config 64 | | ||
Line 529: | Line 575: | ||
This should allow to remote control the MutatoR script from external controllers. | This should allow to remote control the MutatoR script from external controllers. | ||
- | + | </ | |
- | | + | |