Latest revision as of 20:31, 11 July 2023

Advanced Edit

To open the Advanced Edit panel, click on the "A<>E" button at the top right of the Pattern Editor:

The Advanced Edit panel allows you to perform batch operations on pattern and automation data, such as transposing notes, remapping instrument numbers, interpolating effect command values etc. There are multiple sections to the Advanced Edit panel, which can be hidden/shown to either take up less space or to fully reveal their options. Each section deals with a specific topic of modification.

Processing Scope

The first thing that needs to be set up is what will be edited and where this will take place. This is done with the "Section to Process" and "Content Mask" panes at the top:

Section to Process

This section is always visible because it applies to all of the other sections beneath it, by defining what part of the song will be affected:

Selection: Perform actions on what is currently selected in the Pattern Editor.
Column in Pattern: Perform actions on the note or effect column where the cursor is, in the current pattern only.
Column in Song: Perform actions on the current note or effect column where the cursor is, in all patterns.
Track in Pattern: Perform actions on the whole track (all columns) in the currently selected pattern only.
Track in Song: Perform actions on the whole track (all columns) in all patterns.
Group in Pattern: Perform actions on the group in the currently selected pattern only.
Group in Song: Perform actions on the group in all patterns.
Whole Pattern: Perform actions on the entire current pattern.
Whole Song: Perform actions on the entire song; all columns, all tracks and all patterns.

Content Mask

With the Content Mask you can specify what will be processed and what will be ignored. Left-clicking enables/disables a mask. Right-clicking enables a mask, but disables all other masks (solo).

Notes: Apply processing (Cut, Copy, Paste, Flip) on note sub-columns in Note Columns.
Instrument: Apply processing (Cut, Copy, Paste, Flip) on instrument sub-columns in Note Columns.
Volume: Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on volume sub-columns in Note Columns.
Panning: Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on panning sub-columns in Note Columns.
Delay: Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on delay sub-columns in Note Columns.
Effect Number: Apply processing (Cut, Copy, Paste, Flip) on effect numbers in the Effect Columns.
Effect Value: Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on effect values in the Effect Columns.
Automation: Apply processing on graphical Automation attached to the tracks. Copy/pasting Automation in general only works when copying patterns or tracks, not selections.

Performing Actions

All other panels allow you to modify the content you've specified in various ways:

Cut/Copy/Paste

Cut: Copy then delete the content. Not all selections have clipboards and in those cases the "Cut" button will be changed to "Delete".
Copy: Copies the selected content. Not available for all selections.
Paste: Pastes previously copied content.

Flip: Reverse the content in place in the time-line (starting content will become ending content). When applying this to selections which cover more than one pattern, the patterns will be flipped one by one.
Shrink: Halves the length of time that the content takes to play. Note that if the content does not have enough room to be placed on individual lines after being shrunk, some of the content will be removed.
Expand: Doubles the length of time that the content takes to play. This is especially useful when doubling the Lines Per Beat value to add more resolution. If you were to only double the LPB without expanding the content, then it would just play twice as fast as before.

Mix-Paste: When pasting with mix-paste enabled, empty notes, instruments, effects etc. are not copied. This way you can merge the copied selection with the existing content that you're pasting on top of.

Modifying Notes

Safe Mode: Applies transpose settings only when the transposed note does not fall outside of the available octave range in Renoise. With Safe Mode disabled, notes that fall below C-0 or above B-9 will be removed.
Apply to: Either apply the following operation to all instruments in the current selection, or just the one specified in the value box.

Transpose: Transpose notes by a specific amount with the value box and 'Transpose' button, or by a semitone/octave at a time with the four buttons underneath.

Mirror: Swaps every note's height around the specified "center note". This can be very useful for creating variations of melodies.

Preserve Lengths: When enabled, any Note-Offs found within the processing scope will not be quantized.
Quantize: Quantize notes by the given sub-line factor (the factor used in the note delay column). 100 sub-lines (256 in decimal) make up one full line. For example, to quantize by 3 lines, you would use 300 sub-lines. Quantization is covered in-depth in this video.

Nudge: Moves notes up/down by the specified amount of sub-lines.

Modifying Instruments

Src instr.: Select the instrument number that will be modified.
Dest. Instr.: Set the destination instrument number that the source instrument will be transformed into.

Swap: Swap both the source and destination instruments within the selection.
Remap: Swap only the source for the destination within the selection.
Delete: Delete the source instruments within the selection.

Modifying Effects

Using these controls you can interpolate, fill in values, create fades for a given effect, or apply mathematical operations on effect values (multiply, divide, sub, add, randomize and humanize).

Interpolating Values

Suppose you wanted to create a volume fade in a track between the pattern lines 00 and 64. You could type the values in manually, line by line. However, you can instead specify the desired starting and ending values of the fade on lines 00 and 64. Then by selecting the area from 00 to 64 in the appropriate track and using interpolation, the intermediate numbers will automatically and accurately be filled in.

Lin: Create a linear range.
Log: Create a logarithmic range.
Exp: Create an exponential range.

Note that Renoise will require valid starting and ending values in order to perform interpolations. When interpolating effect column values, you must also ensure that the starting and ending effects use the same effect numbers.

To quickly interpolate selections in the Pattern Editor, you can also use the shortcuts, "Left Control/Command + I" to interpolate linearly and "Left Control/Command + L" to interpolate logarithmically.

Modifying Values

Apply Perform the following action, modified by the specified value.
- Set: Set all values in the selection to the specified value.
- Add: Add the specified value to the existing values.
- Sub: Subtract the specified value from the existing values.
- Mul: Multiply the existing values by the specified value.
- Div: Divide the existing values by the specified value.
- Humanize: Randomise the existing values by adding or subtracting a number within the specified value range.

Tip: Humanizing can be used to randomize note delay, volume and panning for instruments. Small variations to such values can create a more human feel.

For example, to humanize drum note delays in a single track for the whole song:

In "Section to Process", enable "Track In Song".
In the "Content Mask", enable "Delays" only.
Set '"10"' as the factor in "Modifying Values" and select "Hum" as the processing type.
Move the cursor to a drum track in the Pattern Editor.
Hit the "Apply" button in "Modifying Values".

You can try repeatedly pressing the "Apply" button, or use values other than "10" to make the effect stronger.

Advanced Edit and Pattern Editor Interaction

Content Mask settings in the Advanced Edit panel (as well as the mix-paste option) also apply to the Pattern Editor's regular Cut, Copy, Paste and Flip commands. So you can apply the mask settings and use Pattern Editor shortcuts to quickly affect selections.

Note that neither Drag and Drop of selections in the Pattern Editor, nor any operation in the Pattern Matrix are influenced by the Advanced Edit options.

@@ Line 1: / Line 1: @@
 = Advanced Edit =
-To open the Advanced Edit panel, click on the ''"A<>E"'' button at the top right of the [[Pattern Editor]]:
+To open the Advanced Edit panel, click on the ''"A<>E"'' button at the top right of the [[Pattern Editor]]: [[Image:3.0_advancededit-open.png|text-bottom]]
-[[Image:vvoois_renoise_advanced_edit_toggle.png]]
-== Overview ==
 The Advanced Edit panel allows you to perform batch operations on pattern and automation data, such as transposing notes, remapping instrument numbers, interpolating effect command values etc. There are multiple sections to the Advanced Edit panel, which can be hidden/shown to either take up less space or to fully reveal their options. Each section deals with a specific topic of modification.
-[[Image:vvoois_renoise_advanced_edit.png]]
+[[Image:3.0_advancededit.png]]
 == Processing Scope ==
-The first thing that needs to be set up is what should be edited and where this should take place. This is done with the ''"Selection to Process"'' and ''"Content Mask"'' pane at the top:
+The first thing that needs to be set up is what will be edited and where this will take place. This is done with the ''"Section to Process"'' and ''"Content Mask"'' panes at the top:
 === Section to Process ===
-[[Image:vvoois_renoise_advanced_edit_ps_options.png]]
+[[Image:3.0_advancededit-sections.png]]
 This section is always visible because it applies to all of the other sections beneath it, by defining what part of the song will be affected:
@@ Line 28: / Line 23: @@
 * '''Track in Pattern:''' Perform actions on the whole track (all columns) in the currently selected pattern only.
 * '''Track in Song:''' Perform actions on the whole track (all columns) in all patterns.
+* '''Group in Pattern:''' Perform actions on the group in the currently selected pattern only.
+* '''Group in Song:''' Perform actions on the group in all patterns.
 * '''Whole Pattern:''' Perform actions on the entire current pattern.
 * '''Whole Song:''' Perform actions on the entire song; all columns, all tracks and all patterns.
@@ Line 33: / Line 30: @@
 === Content Mask ===
-[[Image:vvoois_renoise_advanced_edit_ps_cm.png]]
+[[Image:3.0_advancededit-contentmask.png]]
-With the Content Mask you can specify what should be processed and what should be ignored:
+With the Content Mask you can specify what will be processed and what will be ignored. Left-clicking enables/disables a mask. Right-clicking enables a mask, but disables all other masks (solo).
-* '''Notes: '''Apply processing (Cut, Copy, Paste, Flip) on note sub-columns in Note Columns.
+* '''Notes: '''Apply processing (Cut, Copy, Paste, Flip) on note sub-columns in [[Tracker Interface#Columns|Note Columns]].
-* '''Instrument:''' Apply processing (Cut, Copy, Paste, Flip) on instrument sub-columns in Note Columns.
+* '''Instrument:''' Apply processing (Cut, Copy, Paste, Flip) on instrument sub-columns in [[Tracker Interface#Columns|Note Columns]].
-* '''Volume:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on volume sub-columns in Note Columns.
+* '''Volume:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on volume sub-columns in [[Tracker Interface#Columns|Note Columns]].
-* '''Panning:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on panning sub-columns in Note Columns.
+* '''Panning:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on panning sub-columns in [[Tracker Interface#Columns|Note Columns]].
-* '''Delay:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on delay sub-columns in Note Columns.
+* '''Delay:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on delay sub-columns in [[Tracker Interface#Columns|Note Columns]].
-* '''Effect Number:''' Apply processing (Cut, Copy, Paste, Flip) on effect numbers in the the Effect Columns.
+* '''Effect Number:''' Apply processing (Cut, Copy, Paste, Flip) on effect numbers in the [[Tracker Interface#Columns|Effect Columns]].
-* '''Effect Value:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on effect values in the Effect Columns.
+* '''Effect Value:''' Apply processing (Cut, Copy, Paste, Flip, Interpolate and Modify) on effect values in the [[Tracker Interface#Columns|Effect Columns]].
-* '''Automation: '''Apply processing on graphical Automation attached with the pattern tracks.<br/> Copy/pasting automation in general only works when copying patterns or tracks. Pasting selections wil always exclude automation.
+* '''Automation: '''Apply processing on graphical Automation attached to the tracks. Copy/pasting Automation in general only works when copying patterns or tracks, not selections.
-* Left clicking on the individual check-box enables / disables a mask.
-* Right clicking enables a mask, but disables all other masks (solo).
 == Performing Actions ==
-All panels below the content mask and selection allow you to ''do something ''with the content you've specified above:
+All other panels allow you to modify the content you've specified in various ways:
 === Cut/Copy/Paste ===
-[[Image:vvoois_renoise_advanced_edit_basicp.png]]
+[[Image:3.0_advancededit-cutcopypaste.png]]
-* '''Cut:''' Copy content into the pattern editors clipboard, the delete the content. Not all selections do have clipboards. The "Cut" button will then change to "Delete".
+* '''Cut:''' Copy then delete the content. Not all selections have clipboards and in those cases the "Cut" button will be changed to "Delete".
-* '''Copy:''' Copies the selected content into the clipboard. Not available for all selections
+* '''Copy:''' Copies the selected content. Not available for all selections.
 * '''Paste:''' Pastes previously copied content.
-* '''Flip:''' Reverse the content in place in the timeline (starting content will get ending content)-. When applying this on selections which cover more than one pattern, patterns will be flipped one by one.
+* '''Flip:''' Reverse the content in place in the time-line (starting content will become ending content). When applying this to selections which cover more than one pattern, the patterns will be flipped one by one.
-* '''Shrink:''' Half the checked contents time, make a content play twice as fast as before.
+* '''Shrink:''' Halves the length of time that the content takes to play. Note that if the content does not have enough room to be placed on individual lines after being shrunk, some of the content will be removed.
-* '''Expand:''' Double the checked contents time, make a content play twice as fast as before. This is especially useful when doubling the [[LPB|Lines Per Beat]] value to add more resolution for your patterns. If you would only double the LPB without expanding the content, the song would simply play twice as fast as before.
+* '''Expand:''' Doubles the length of time that the content takes to play. This is especially useful when doubling the [[Transport_Panel|Lines Per Beat]] value to add more resolution. If you were to only double the LPB without expanding the content, then it would just play twice as fast as before.
-'''Mix-Paste:''' When pasting with mix-paste is enabled, empty notes, instruments, effects and so on are not copied. This way you can merge the existing content with the one from the clipboard.
+'''Mix-Paste:''' When pasting with mix-paste enabled, empty notes, instruments, effects etc. are not copied. This way you can merge the copied selection with the existing content that you're pasting on top of.
 === Modifying Notes ===
-The next panel applies either to entire note columns (Note, Instrument, Volume, Pan and Delay sub columns):
+[[Image:3.0_advancededit-notes.png]]
-[[Image:vvoois_renoise_advanced_edit_ap_transnotes.png]]
+* '''Safe Mode:''' Applies transpose settings only when the transposed note does not fall outside of the available octave range in Renoise. With Safe Mode disabled, notes that fall below C-0 or above B-9 will be removed.
+* '''Apply to:''' Either apply the following operation to all instruments in the current selection, or just the one specified in the value box.
-* '''Safe Mode:''' Applies transpose settings only when the transposed note does not fall outside of the available octave range. With safe-mode disabled notes that fall below a C-0 or C-10 will be removed.
+* '''Transpose:''' Transpose notes by a specific amount with the value box and 'Transpose' button, or by a semitone/octave at a time with the four buttons underneath.
-* '''Apply to:''' Either apply the following operation on all instruments in the current selection, or just a specific one.
-* '''Transpose:''' Transpose notes semitone or octave wise up or done.
+* '''Mirror:''' Swaps every note's height around the specified ''"center note"''. This can be very useful for creating variations of melodies.
-* '''Mirror:''' Swaps every note's height around the specified ''center note''. This can be very interesting for creating variations of melodies.
-* '''Preserve Lengths:''' When using the quantize function, Note-Offs will not be quantized, but retain their original distance to the Note-On.
-* '''Quantize:''' Quantize notes by the given subline factor. The subline factor is the factor that used in the note delay column. 100 sublines (decimal 256) are one full line. If you want to quantize by 3 lines, you would use 300 sublines.
+* '''Preserve Lengths:''' When enabled, any [[Playing_Notes_with_the_Computer_Keyboard#Note_Off|Note-Offs]] found within the [[#Processing Scope|processing scope]] will not be quantized.
-* '''Nudge:''' moves notes up/down by the specified amount of sublines (again 100 sublines are a full line).
+* '''Quantize:''' Quantize notes by the given sub-line factor (the factor used in the [[Tracker_Interface#Columns|note delay column]]). [[Tracker Interface#Hexadecimal|100 sub-lines]] (256 in decimal) make up one full line. For example, to quantize by 3 lines, you would use 300 sub-lines. Quantization is covered in-depth [https://youtu.be/dGkoKWA-2Dg in this video].
+* '''Nudge:''' Moves notes up/down by the specified amount of sub-lines.
 === Modifying Instruments ===
-[[Image:vvoois_renoise_advanced_edit_ap_transins.png]]
+[[Image:3.0_advancededit-instruments.png]]
-* '''Src instr.:''' Select the instrument number that should be modified.
+* '''Src instr.:''' Select the instrument number that will be modified.
-* '''Dest. Instr.:''' Select the destination instrument number, to what the source insturment number should be transformed.
+* '''Dest. Instr.:''' Set the destination instrument number that the source instrument will be transformed into.
-* '''Swap:''' Swap the source and destination instruments within the selection.
+* '''Swap:''' Swap both the source and destination instruments within the selection.
-* '''Remap:''' use the destination instrument for all matching source instruments in the given range.
+* '''Remap:''' Swap only the source for the destination within the selection.
-* '''Delete:''' Erase specific notes that instruments will be erased from the Section to Process.
+* '''Delete:''' Delete the source instruments within the selection.
 === Modifying Effects ===
-[[Image:vvoois_renoise_advanced_edit_ap_transform.png]]
+[[Image:3.0_advancededit-volpandelfx.png]]
-Let you either interpolate, fill in ''missing values'', create fades for a given effect, or applies mathematical operations on effect values (multiply, divide, sub, add, randomize and humanize).
+Using these controls you can interpolate, fill in values, create fades for a given effect, or apply mathematical operations on effect values (multiply, divide, sub, add, randomize and humanize).
 ==== Interpolating Values ====
-Suppose you want to do a volume fade in a track between pattern line 00 and pattern line 64. Now you can, of course, type in manually all the values on each line in either the effect column or the volume column of the subtrack you want to fade. Instead of doing this by hand, you can set also only specify the first and last values on line 00 and the last line 64. Selecting the first and last line and hitting interpolate will now fill in all missing numbers and values.
+Suppose you wanted to create a volume fade in a track between the pattern lines 00 and 64. You could type the values in manually, line by line. However, you can instead specify the desired starting and ending values of the fade on lines 00 and 64. Then by selecting the area from 00 to 64 in the appropriate track and using interpolation, the intermediate numbers will automatically and accurately be filled in.
-* Lin - Create a linearly range from start to end
+* '''Lin:''' Create a linear range.
-* Log - Create a logarithmic range from start to end
+* '''Log:''' Create a logarithmic range.
-* Exp - Create an exponential range from start to end.
+* '''Exp:''' Create an exponential range.
-Please note that Renoise always needs valid starting and end values to perform interpolations. When interpolating effect column values, you must also ensure that the starting and ending effects use the same effect numbers.
+Note that Renoise will require valid starting and ending values in order to perform interpolations. When interpolating effect column values, you must also ensure that the starting and ending effects use the same effect numbers.
-To quickly interpolate selections in the Pattern Editor, you can also use the shortcut "CONTROL/COMMAND + I" to interpolate linearly, "CONTROL/COMMAND + L" to interpolate logarithmically.
+To quickly interpolate selections in the Pattern Editor, you can also use the shortcuts, ''"Left Control/Command + I"'' to interpolate linearly and ''"Left Control/Command + L"'' to interpolate logarithmically.
 ==== Modifying Values ====
-[[Image:vvoois_renoise_advanced_edit_ap_transform_asmh.png]]
+[[Image:3.0_advancededit-modifiers.png]]
+* '''Apply''' Perform the following action, modified by the specified value.
+** '''Set:''' Set all values in the selection to the specified value.
+** '''Add:''' Add the specified value to the existing values.
+** '''Sub:''' Subtract the specified value from the existing values.
+** '''Mul:''' Multiply the existing values by the specified value.
+** '''Div:''' Divide the existing values by the specified value.
+** '''Humanize:''' Randomise the existing values by adding or subtracting a number within the specified value range.
-* '''Apply''' Perform the set up action (action type and factor)
+'''Tip:''' Humanizing can be used to randomize note delay, volume and panning for instruments. Small variations to such values can create a more human feel.
-** '''Set:''' Set all values as set up in the content mask to the given new value
-** '''Add:''' Add the given value to the existing values in the specified range
-** '''Sub:''' Subtract the given value
-** '''Mul:''' Multiply with the given factor
-** '''Div:''' Divide by the given factor
-** '''Hum:'' Add a small random amount, 'humanizes' for the items in the mask in the specified selection.
+For example, to humanize drum note delays in a single track for the whole song:
-Tip: humanizing can be very easily and effectively be used to randomize note timings for drums. Same applies for volume and panning values. Small variations to such values or times often create a more swinging, human feeling.
+# In ''"Section to Process"'', enable ''"Track In Song"''.
+# In the ''"Content Mask"'', enable ''"Delays"'' only.
+# Set '"10"' as the factor in ''"Modifying Values"'' and select ''"Hum"'' as the processing type.
+# Move the cursor to a drum track in the Pattern Editor.
+# Hit the ''"Apply"'' button in ''"Modifying Values"''.
-To humanize note delays in a given track in the whole song:
+You can try repeatedly pressing the ''"Apply"'' button, or use values other than ''"10"'' to make the effect stronger.
-# In ''Section to Process'' enable '''Track In Song'''
-# In the ''Content Mask'' enable '''Delays''' only
-# Setup '10' as factor in ''Modifying Values'' and select 'Hum' as processing type.
-# Move the cursor in the Pattern Editor to a drum track
-# Hit the 'Apply' button in ''Modifying Values''
-You can try hitting it again and again or other values than '10' to make the effect stronger. Try this also with only ''Volume'' or ''Panning'' in the Content Mask...
 == Advanced Edit and Pattern Editor Interaction ==
-Content Mask settings in the Advanced Editor also apply to the Pattern Editors regular Cut / Copy / Paste and Flip commands. Same is true for the mix-paste option. This way you can quickly use the Pattern Editors shortcuts as usual in new fashions. If you for example don't want to Copy / Paste automation along with patterns in a session,you can simply do this this way.
+Content Mask settings in the Advanced Edit panel (as well as the mix-paste option) also apply to the Pattern Editor's regular Cut, Copy, Paste and Flip commands. So you can apply the mask settings and use Pattern Editor shortcuts to quickly affect selections.
-Drag-and-Drop of selections in the Pattern Editor and all operations in the Pattern Matrix will not use any Advanced Edit options.
+Note that neither Drag and Drop of selections in the Pattern Editor, nor any operation in the Pattern Matrix are influenced by the Advanced Edit options.

Advanced Edit: Difference between revisions