Latest revision as of 17:21, 7 April 2022

Phrase Editor

With the Phrase Editor you can compose musical phrases that will be activated when specific notes are played. Phrases are created using a scaled-down version of the Renoise Pattern Editor, consisting of just a single track and pattern. While both Redux and Renoise use samples to create phrases, Renoise can also make use of the Plugin and MIDI components of an instrument.

Instruments are recorded by entering notes onto lines in the order that they are to be played, from top to bottom. This is done with the Tracker Interface, so if you're unfamiliar with this method of working, you should read through that section of the manual before continuing here. An instrument can feature up to 120 different phrases, one for each available key. Phrases are part of an instrument (.xrni) and so are loaded/saved along with any samples and other instrument data.

Phrases (.xrnz) can be loaded and saved as presets using the drop-down menu located at the top right corner.

Creating Phrases

If an instrument does not have an existing phrase then the button will need to be pressed.

While the Phrase Editor is open, notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to still enter notes as normal without triggering the phrase you're working on. However, notes played via a MIDI device or the on-screen keyboard will trigger the phrase itself. Recording notes and effects is done by the exact same method used for the Pattern Editor. The phrase length (number of lines) is changed by altering the value in the box at the top left corner of the phrase. A phrase can be renamed by double-clicking on its name at the top of the phrase and typing in a new one.

Pattern Editor Effect Variations (Renoise only)

A few Effect Commands will behave differently when used in the Renoise Pattern Editor to affect a phrase:

-Bxx - Play phrase backwards (xx = 00) or forwards (xx = 01).
-Sxx - Trigger phrase from line xx.
-Ixx, -Oxx, -Txy - Will also affect any Plugin or MIDI playing in the phrase.

Phrase Editor Options

These options are found at the bottom of the Phrase Editor interface. The drop down menus can quickly insert notes or commands into the relevant sections, while the sliders will insert values.

Edit Step: Sets how many lines the cursor should skip down in the Phrase Editor when entering a note or effect.
##/Vol/Pan/Dly/FX: Toggles the sample, volume, panning, delay and local FX sub-columns.

Automatically Generating A Phrase

It's possible to automatically generate a phrase using notes and effect commands from the Pattern Editor. Right-click on the track/column you would like to source from and choose 'Create Phrase' from the Track/Column sub-menu. Alternatively, select an area and choose 'Create Phrase' from the Selection sub-menu. Note that this method is restricted to sourcing from a single instrument in a single track.

Phrase Controls

With the controls at the bottom-right of the interface you can select phrases from the grid and preview them with the play and stop buttons. The +/- buttons can be used to insert a new phrase or delete the selected phrase. It's also possible to duplicate a phrase by right-clicking on it and selecting 'Duplicate' from the menu.

The three buttons at the bottom-right are used to either turn phrases off entirely or select the playback method. Program mode is usually a good choice, as it allows unrestricted access to the entire range of the MIDI keyboard. For convenient access to phrases in Program mode, it's recommended to assign the various programs to separate buttons on your MIDI controller. If your host supports the recording of program changes, it should be possible to capture a performance where you switch programs on-the-fly.

The Zxx effect command or an *Instrument Macros device can be used to automatically change an instrument's phrase as the song is playing.

Phrases in Keymap Mode

In Keymap mode, phrases can be played across a range of keys and are shown spanning this range above the keyboard. A phrase can be selected by left-clicking on it, making it the active phrase with a highlighted colour and its properties displayed above the keyboard. You can shrink/expand the range of an active phrase by click-dragging its left or right edge, though phrases cannot overlap each other. Click-dragging the phrase body (not the edges) will move it around.

If you hold down "Left Shift" and left-click on another phrase, both this and the active phrase are selected, along with any phrases between them. When multiple phrases are selected, any changes made to the active phrase will also affect the others.

To insert additional phrases just double-click on a blank space in the phrase area above the keyboard. If there is no blank space, you will need to shrink an existing phrase to make room (phrase ranges cannot overlap). A phrase can be deleted or duplicated by right-clicking on it and selecting the appropriate option from the context menu. Phrases can also be duplicated by holding Ctrl and click-dragging to a blank area of suitable size (the duplication will fail if the area is too small).

Changing Triggering Mode

For even greater flexibility, you can switch between these behaviours in real-time. The triggering mode is controlled via MIDI program change events. This illustration shows how the values are distributed:

0 turns phrases Off entirely. 1-126 is Program Mode, with the value selecting a specific phrase. 127 activates Keymap Mode.

Phrase Properties

These options are found just above the keyboard and can be different for each individual phrase.

Edit: (Redux only) Toggle Edit Mode. With Edit Mode enabled, all notes played via the keyboard are recorded into the pattern/phrase.
Beats per Minute: (Redux only) The current tempo of the phrase, also known as BPM. This value is set by the host DAW.
Lines per Beat: This changes the number of lines in the Phrase Editor that make up a musical beat. The higher the LPB, the greater the resolution available to you for editing notes and effects. A phrase's LPB operates independently from the song's LPB.
Shuffle: Shifts the playback timing of each alternate line back and forth to create a 'swinging' feel. Higher values have a more intense effect, while 0% disables it entirely. The playback style is affected by Lines per Beat values above 4, which groups multiple lines together and delays them as a whole instead of individually. You may find it useful to watch our video, Global Groove & Phrase Shuffle.
Autoseek: (Renoise only) During song playback, a phrase is normally only heard once it has been triggered by reaching its position in the pattern. Enabling Autoseek allows the phrase to be heard at any point during song playback without the need for triggering. Note that Autoseeking for samples does not function within a phrase.
Loop: Toggles whether the phrase will loop upon reaching the end.
- Start & End Lines: Specifies the start and end lines of the Loop.
Key Tracking: Sets the behaviour of the phrase across a key range.
- None: The phrase is played exactly the same for all keys.
- Transpose: The pitch of the phrase's notes are transposed to the key played. The playback speed of the phrase is unaffected.
- Offset: Different keys will cause the phrase to begin playing from different lines (lower keys from earlier in the phrase, higher keys from later).
Base Note: The note representing the original pitch of the phrase when "Key Tracking" is set to "Transpose". Renoise only: This can also be changed by right-clicking a note on the keyboard, where the current Base Note is shown as a black circle.

@@ Line 1: / Line 1: @@
 = Phrase Editor =
-Time runs vertically in a tracker, moving down line-by-line from the top of a phrase to the bottom. So during playback of a phrase, the notes or commands found in each line are triggered in sequence. With the Phrase Editor you can compose musical phrases that will be activated when specific notes are played. Phrases are created using a scaled-down version of the Renoise [[Pattern Editor]], consisting of just a single pattern.
+With the Phrase Editor you can compose musical phrases that will be activated when specific notes are played. Phrases are created using a scaled-down version of the Renoise [[Pattern Editor]], consisting of just a single track and pattern. While both Redux and Renoise use samples to create phrases, Renoise can also make use of the [[Plugin]] and [[MIDI]] components of an instrument.
-An instrument can feature up to 120 different phrases, one for each key. Phrases are part of an instrument (.xrni) and so are loaded/saved along with any samples and other instrument data.
+Instruments are recorded by entering notes onto lines in the order that they are to be played, from top to bottom. This is done with the [[Tracker Interface]], so if you're unfamiliar with this method of working, you should read through that section of the manual before continuing here. An instrument can feature up to 120 different phrases, one for each available key. Phrases are part of an instrument (.xrni) and so are loaded/saved along with any samples and other instrument data.
-Phrases (.xrnz) can be loaded and saved as presets using [[Specific Preset Types|the drop-down menu located at the top right corner]].
+Phrases (.xrnz) can be loaded and saved as presets using [[Libraries#Specific Preset Types|the drop-down menu located at the top right corner]].
-[[Image:3.1_phrases.png]]
+[[Image:3.2_phrases.png]]
 == Creating Phrases ==
-If an instrument does not have an existing phrase then the [[Image:3.0_phraseeditor-createphrase.png|text-bottom]] button will need to be pressed. In Renoise, On/Off buttons will appear above the Phrase Editor button to enable/disable an instrument's phrases.
+If an instrument does not have an existing phrase then the [[Image:3.0_phraseeditor-createphrase.png|text-bottom]] button will need to be pressed.
-While editing a phrase, notes played with the computer keyboard will play the instrument as normal, but notes played via a MIDI device or the [[Instruments#Keyboard|on-screen keyboard]] will trigger the phrase itself. [[Recording and Editing Notes|Recording notes and effects]] is done by the exact same method used for the [[Pattern Editor]]. The [[#Lines|phrase length (number of lines)]] is changed by altering the value in the box at the top left corner of the phrase. A phrase can be renamed by double-clicking on its name and typing in a new one.
+While the Phrase Editor is open, notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to still enter notes as normal without triggering the phrase you're working on. However, notes played via a MIDI device or the [[Instruments#Keyboard|on-screen keyboard]] ''will'' trigger the phrase itself. [[Recording and Editing Notes|Recording notes and effects]] is done by the exact same method used for the [[Pattern Editor]]. The [[Tracker Interface#Lines|phrase length (number of lines)]] is changed by altering the value in the box at the top left corner of the phrase. A phrase can be renamed by double-clicking on its name at the top of the phrase and typing in a new one.
-=== Columns ===
-There are two different types of column in a phrase: note and effect. There can be up to twelve note-columns, which are used to [[Recording_and_Editing_Notes|record instruments by entering notes]]. They also have three extra sub-columns, which are used to control the volume, panning and delay parameters on a per-note basis. The panning and delay sub-columns are not visible by default. To show/hide them you can use the keyboard shortcuts, ''"Left Control/Command + Left Shift + V (Volume), P (Panning), D (Delay)"'', or you can press the corresponding buttons in the [[#Phrase Editor Controls|Phrase Editor Controls]].
-Effect columns are used to apply [[Effect Commands]] that can affect the behaviour of [[Instruments]]. They are set up in the format: ''xxyy'', where ''xx'' defines the effect type (e.g. pitch glide) and ''yy'' defines the effect's value (e.g. the rate of the pitch glide). There can be up to eight master effect-columns and an optional local effect-column for each note-column.
-The image below illustrates the typical layout of a phrase:
-[[Image:dux1.0_phrases-columns.png]]
-* '''Note:''' e.g. C-4, A#3. The first two characters represent the musical note, while the third character is the octave number. The notes are not entered letter by letter like a text editor, but like a piano, [[Recording_and_Editing_Notes|using the computer keyboard or a MIDI master keyboard]].
-* '''Sample Number:''' The sample that will play the note. This is automatically entered when the note is recorded, but it can be changed by hand.
-* '''Volume:''' (00-80) - The note velocity/volume, where 00=minimum and 80=maximum. [[Effect Commands#Volume or Panning Column|Additional effects]] can also be triggered from here.
-* '''Panning:''' (00-80) - The panning of the note, where 00=full left, 40=center and 80=full right. In Renoise, this will only be applied to [[Sampler|samples]] ([[MIDI]] and [[Plugin|VST]] plugins will be unaffected by values in this sub-column). [[Effect Commands#Volume or Panning Column|Additional effects]] can also be triggered from here.
-* '''Delay:''' (00-FF) - A time delay added to the note, where 00 is no delay and FF will result in the note being delayed until immediately before the next line.
-* '''Local FX:''' [[Effect Commands]] entered into this column will only affect the samples being played in this particular note column.
-* '''Master FX:''' [[Effect Commands]] entered into this column will affect the entire phrase.
-==== Adding / Removing Columns ====
-To add/remove Note or Effect columns, you can use the [[Image:dux1.0_tracks-add-delete.png]] buttons at the top of the phrase. Alternatively, you can use the shortcut, ''"Left Control/Command + Left Shift + left/right arrow key"'' to either add/remove a Note or Effect column, depending on where the cursor is (place it where you would like that column type to be duplicated).
 === Pattern Editor Effect Variations ''(Renoise only)'' ===
-A few commands will behave differently when used in the Renoise [[Pattern Editor]] to affect a phrase:
+A few [[Effect Commands]] will behave differently when used in the Renoise [[Pattern Editor]] to affect a phrase:
-* '''0Bxx''' - Play phrase backwards (xx = 00) or forwards (xx = 01).
+* '''-Bxx''' - Play phrase backwards (xx = 00) or forwards (xx = 01).
-* '''0Sxx''' - Trigger phrase from line xx.
+* '''-Sxx''' - Trigger phrase from line xx.
-* '''0Ixx''', '''0Oxx''', '''0Txy''' - Will also affect any [[Plugin]] or [[MIDI]] playing in the phrase.
+* '''-Ixx''', '''-Oxx''', '''-Txy''' - Will also affect any [[Plugin]] or [[MIDI]] playing in the phrase.
-=== Lines ===
-Each individual phrase can have a different length, from 1 to 512 lines, which can be changed by altering the value in the box at the top left of the Phrase Editor: [[Image:3.1_phrases-lines.png|text-bottom]]
-==== Lines, Beats and Pattern Resolution ====
-In the [[#Phrase Properties|Phrase Properties panel]] there is an LPB option, which changes the number of lines in the Phrase Editor that make up a musical beat. The higher the LPB, the greater the resolution available to you for editing notes, effects and automation. This can be can be a different value for each individual phrase.
-By default the LPB is 4, meaning that placing a note on every highlighted line will create a simple 4/4 beat in a pattern that is 16 lines long.  How many lines you use for a beat is totally up to you, but it can be important to get it correct if you're using Renoise/Redux to interact with other beat-based instruments or sequencers, (e.g. plugins which use beat timings) or when syncing a song/phrase with other applications via ReWire.
-When working with time signatures other than 4/4, it's useful to set your number of lines in a pattern to a factor of the time signature's numerator multiplied by the LPB. For example, when working in 3/4 and a LBP of 4, you could use a pattern length of 12, 24 or 48; when working in 5/4 you could use a pattern length of 20 or 40 etc. This will allow you to place your notes on exact phrase lines without having to delay notes with the delay column.
 === Phrase Editor Options ===
@@ Line 65: / Line 31: @@
 * '''Edit Step:''' Sets how many lines the cursor should skip down in the Phrase Editor when entering a note or effect.
-* '''##:''' Toggles the sample sub-column.
+* '''##/Vol/Pan/Dly/FX:''' Toggles the [[Tracker Interface#Columns|sample, volume, panning, delay and local FX sub-columns]].
-* '''Vol/Pan/Dly:''' Toggles the [[Pattern Editor#Columns|volume, panning and delay sub-columns]].
-* '''FX:''' Toggle the effect column for the individual note columns.
+=== Automatically Generating A Phrase ===
+It's possible to automatically generate a phrase using notes and effect commands from the Pattern Editor. Right-click on the track/column you would like to source from and choose 'Create Phrase' from the Track/Column sub-menu. Alternatively, [[Tracker_Interface#Navigating_.26_Selecting|select an area]] and choose 'Create Phrase' from the Selection sub-menu. Note that this method is restricted to sourcing from a single instrument in a single track.
@@ Line 74: / Line 42: @@
 [[Image:3.1_phrases-controls.png]]
-With the controls at the bottom right of the interface you can select phrases from the grid, create or delete phrases (+/- buttons), preview them with the play and stop buttons and choose their playback method. Program mode is usually a good choice, as it allows unrestricted access to the entire range of the MIDI keyboard. For convenient access to phrases in Program mode, it's recommended to assign the various programs to separate buttons on your MIDI controller. If your host supports the recording of program changes, it should be possible to capture a performance where you switch programs on-the-fly.
+With the controls at the bottom-right of the interface you can select phrases from the grid and preview them with the play and stop buttons. The +/- buttons can be used to insert a new phrase or delete the selected phrase. It's also possible to duplicate a phrase by right-clicking on it and selecting 'Duplicate' from the menu.
+The three buttons at the bottom-right are used to either turn phrases off entirely or select the playback method. Program mode is usually a good choice, as it allows unrestricted access to the entire range of the MIDI keyboard. For convenient access to phrases in Program mode, it's recommended to assign the various programs to separate buttons on your MIDI controller. If your host supports the recording of program changes, it should be possible to capture a performance where you switch programs on-the-fly.
+The [[Effect_Commands#Instrument_Commands|Zxx effect command]] or an [[Meta_Devices#.2AInstrument_Macros|*Instrument Macros device]] can be used to automatically change an instrument's phrase as the song is playing.
 === Phrases in Keymap Mode ===
@@ Line 80: / Line 52: @@
 [[Image:3.1_phrases-keymap.png]]
-Phrases can be played across a range of keys and are shown spanning this range above the [[Instruments#Keyboard|keyboard]]. A phrase can be selected by left-clicking on it, making it the active phrase with a highlighted colour and its [[#Phrase Properties|properties]] displayed above the keyboard. You can shrink/expand the range of an active phrase by click-dragging its left or right edge, though phrases cannot overlap each other. Click-dragging the phrase body (not the edges) will move it around.
+In Keymap mode, phrases can be played across a range of keys and are shown spanning this range above the [[Instruments#Keyboard|keyboard]]. A phrase can be selected by left-clicking on it, making it the active phrase with a highlighted colour and its [[#Phrase Properties|properties]] displayed above the keyboard. You can shrink/expand the range of an active phrase by click-dragging its left or right edge, though phrases cannot overlap each other. Click-dragging the phrase body (not the edges) will move it around.
 If you hold down "Left Shift" and left-click on another phrase, both this and the active phrase are selected, along with any phrases between them. When multiple phrases are selected, any changes made to the active phrase will also affect the others.
-To insert additional phrases just double-click on a blank space in the phrase area. If there is no blank space, you will need to shrink an existing phrase to make room (phrase ranges cannot overlap). A phrase can be deleted or duplicated by right-clicking on it and selecting the appropriate option from the context menu. Phrases can also be duplicated by holding Ctrl and click-dragging to a blank area of suitable size (the duplication will fail if the area is too small).
+To insert additional phrases just double-click on a blank space in the phrase area above the [[Instruments#Keyboard|keyboard]]. If there is no blank space, you will need to shrink an existing phrase to make room (phrase ranges cannot overlap). A phrase can be deleted or duplicated by right-clicking on it and selecting the appropriate option from the context menu. Phrases can also be duplicated by holding Ctrl and click-dragging to a blank area of suitable size (the duplication will fail if the area is too small).
 === Changing Triggering Mode ===
-For even greater flexibility, you can switch between these behaviours in real-time. The triggering mode is controlled via MIDI program change events. This illustration shows how the values are distributed:
+For even greater flexibility, you can switch between these behaviours in real-time. The triggering mode is controlled via [[MIDI#MIDI_Messages|MIDI program change events]]. This illustration shows how the values are distributed:
 [[Image:dux1.0_phrases-triggeringmodes.png]]
@@ Line 97: / Line 69: @@
 == Phrase Properties ==
-[[Image:dux1.0_phrases-phraseproperties.png]]
+[[Image:3.2_phrases-properties.png]]
+[[Image:dux1.1_phrases-phraseproperties.png]]
 These options are found just above the [[Instruments#Keyboard|keyboard]] and can be different for each individual phrase.
@@ Line 104: / Line 78: @@
 * '''Beats per Minute:''' ''(Redux only)'' The current tempo of the phrase, also known as BPM. This value is set by the host DAW.
 * '''Lines per Beat:''' This changes the number of lines in the Phrase Editor that make up a musical beat. The higher the LPB, the greater the resolution available to you for editing notes and effects. A phrase's LPB operates independently from the [[Transport Panel|song's LPB]].
-* '''Shuffle:''' Shifts the playback timing of lines back and forth to create a 'swinging' feel. Higher values have a more intense effect, while 0% disables it entirely.
+* '''Shuffle:''' Shifts the playback timing of each alternate line back and forth to create a 'swinging' feel. Higher values have a more intense effect, while 0% disables it entirely. The playback style is affected by Lines per Beat values above 4, which groups multiple lines together and delays them as a whole instead of individually. You may find it useful to watch our video, [https://youtu.be/lvTrl0rXzMU Global Groove & Phrase Shuffle.]
+* '''Autoseek:''' ''(Renoise only)'' During song playback, a phrase is normally only heard once it has been triggered by reaching its position in the pattern. Enabling Autoseek allows the phrase to be heard at any point during song playback without the need for triggering. Note that [[Sampler#Sample Properties|Autoseeking for samples]] does not function within a phrase.
 * '''Loop:''' Toggles whether the phrase will loop upon reaching the end.
 ** '''Start & End Lines:''' Specifies the start and end lines of the Loop.
@@ Line 111: / Line 86: @@
 ** '''Transpose:''' The pitch of the phrase's notes are transposed to the key played. The playback speed of the phrase is unaffected.
 ** '''Offset:''' Different keys will cause the phrase to begin playing from different lines (lower keys from earlier in the phrase, higher keys from later).
-* '''Base Note:''' The note representing the original pitch of the phrase when ''"Key Tracking"'' is set to ''"Transpose"''. ''Renoise only: This can also be changed by right-clicking a note on the [[Instruments#Keyboard|keyboard]], where the current Base note is shown as a black circle''.
+* '''Base Note:''' The note representing the original pitch of the phrase when ''"Key Tracking"'' is set to ''"Transpose"''. ''Renoise only: This can also be changed by right-clicking a note on the [[Instruments#Keyboard|keyboard]], where the current Base Note is shown as a black circle''.

Phrase Editor: Difference between revisions