EditStepTweaks tool for Renoise ------------------------------- NEW STUFF IN 1.4: ----------------- -GUI optimization -Shortcuts for moving 1 row up / down (normal row movement keys) -Renamed a wrapping option more descriptively 1. USAGE -------- 1.1 GENERAL Bring up the options dialog under Tools-menu (EditStepTweaks...), to select and finetune your tweaks. The tweaks are discussed further under a dedicated section. To save some pixels, the tweak settings are folded under collapsible in the GUI. To edit your settings, click on a tweak subsection title, and its settings subpanel will open. 1.2. IMPORTANT NOTES The movement enhancing features (options under Zero Tweak, No Rams, Wrapping) of the tool work by overriding your normal movement keys. Due to renoise Lua API architecture, this cannot be done by tool itself. Instead, it works so that you must rebind your Renoise movement keys under the keyboard shortcut settings. The tool provides shortcuts for all the default row movement keys in renoise. These are listed in section 3, below. Due to limitations in the current API, the tool only adjusts cursor movement behaviour for the navigation keys. This means that it can not override the cursor movement when entering notes into the pattern. The movement tweaks under wrapping and no rams will not be effective when entering notes. 2. TWEAKS AND IMPROVEMENTS -------------------------- 2.1. ZEROEDIT TWEAK To use this tweak: - ensure you have rebound your EditStep navigation keys - activate option checkbox in dialog - decide and select your method This tweak will override the EditStep navigation keys settings, when your EditStep is set to zero. If your EditStep is set to zero, the "Move w/ EditStepTweak" -shortcuts will still move the cursor up and down. Editing anything in the pattern will behave just as normal, the cursor does not move. The usage scenario for the zeroedit tweak is that one can bind the EditStep navigation keys into the regular, non-modifier up & down keys, and still be sure that no modifiers are needed for row navigation in any case. To select what the EditStep count for navigation will be if the EditStep is set to zero, you have two options under the "Method" -chooser. You can choose to use a step of 1 row, or to use the latest EditStep count that was active before EditStep was set to zero. In effect, the latter option accommodates an editing scenario where your editing is done with step 0, but you can still navigate with your desired EditStep value. For example to edit with EditStep 0, and use EditStep 8 for navigation, first set EditStep to 8, then set it to 0. 2.2. NO RAMS TWEAK To use this tweak: - ensure you have rebound all your row navigation keys - activate option checkbox in dialog This option assures that you cannot lose your place on the EditStep grid, if you happen to ram the bottom of the last pattern in sequence and have continuous mode on. When activated, this tweak works by checking whether the next jump (with EditStep) would be outside the pattern sequence. If it would, the cursor does not move. The vanilla renoise EditStep navigation keys would still move the cursor by ramming it against pattern end, end up in the last row and thus off the EditStep grid. This is also how this tool behaves if this tweak is not activated. The bottom option is much more useful in my opinion, but for purists there are options for both sides. 2.3. PLAYBACK TWEAK To use this tweak: - activate option checkbox in dialog - decide and select your method This option relies on a notifier that watches playback state. Whenever playback is stopped, tool makes an attempt to align the cursor on the EditStep grid. This is to avoid the situation where you have to manually align the cursor into the grid every time you stop playback, and have been editing something with an EditStep value of something else than 1. To select what EditStep grid to align into, if the EditStep is set to zero, you have two options under the "When ES=0" -chooser. You can choose to use a stepgrid of 1 row, which essentially means no aligning if EditStep is 0, or to use the latest EditStep that was active before EditStep was set to zero. There is an option to ignore current state of "Follow playback". This is to avoid conflicts with tools that themselves adjust "Follow playback" in some manner. If set, the tool will always align edit cursor when playback is stopped. If this option is NOT set, the tool will only attempt to align the edit cursor when stopping playback AND the renoise's "Follow playback" -mode is on. Technical note: The EditStep grid is calculated from the current pattern start. 2.4. WRAPPING TWEAKS To use these tweaks: - ensure you have rebound all your row navigation keys - activate option checkboxes in dialog These options tweak the renoise's edit cursor wrapping settings. "Wrap song in continuous edit mode" makes the cursor wrap around the entire song, when continuous mode is on. This works for all key binds generated by EditStepTweaks. Normal movement keys won't be affected. "Wrap pattern in non-cont mode" allows to fix an inconsistency with the way renoise normally wraps the cursor. If you don't have continuous pattern mode on, your EditStep navigation keys will now loop around the pattern just like normal row navigation keys. The vanilla renoise EditStep navigation keys would not loop around the pattern. 3. KEYBOARD SHORTCUTS --------------------- All of these can be found under Pattern Editor:Navigation. ----------------------------------------------------------------------------- Moving with edit step: original = "Move to previous row with EditStep" original = "Move to next row with EditStep" EST equivalent = "Move to previous row w/ EditStepTweak" EST equivalent = "Move to next row w/ EditStepTweak" These are just your regular moving prev/next row (or up/down) with EditStep shortcuts with additional special tool-sauce. Replace your EditStep navigation shortcuts with these, if you wish to use the Zeroedit Tweak and No rams Tweak. Binding these will also activate the general improvements (section 2.4.). ----------------------------------------------------------------------------- Moving 1 row: original = "Move to previous row" original = "Move to next row with EditStep" EST equivalent = "Jump 1 Row Up w/ EditStepTweak" EST equivalent = "Jump 1 Row Dn w/ EditStepTweak" These are the tool-enhanced equivalents for the normal key binds for moving a single row. As for your 'WHY SHOULD I BIND THESE' question, the answer is that these will respect the Wrapping tweaks. ----------------------------------------------------------------------------- Moving 16 rows: original = "Jump 16 Rows Up" original = "Jump 16 Rows Down" EST equivalent = "Jump 16 Row Dn w/ EditStepTweak" EST equivalent = "Jump 16 Row Up w/ EditStepTweak" These are the tool-enhanced equivalents for the normal key binds for jumping a 16 row block at a time. These will respect the No rams and Wrapping tweaks. ----------------------------------------------------------------------------- Other shortcuts: - Align cursor to EditStep grid This shortcut will manually do what the Playback Tweak does automatically. If you wish not to use the Playback Tweak, but need a way to quickly align to the EditStep grid, bind this to a keyboard shortcut. When your EditStep is set to 0, this shortcut uses the preferences you have set on the Playback Tweak's "When ES=0" -option.