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. | ||
| - | + | </ | |
| - | | + | |
_ki