Pattern Effect Commands

Track DSP parameters can be automated with either Graphical Automation or pattern effects. Pattern effects are numerical control codes used in the Pattern Editor that allow you to change the value of parameters.

Besides controlling Track DSPs, the pattern effect commands also allow various manipulations of sample instruments. These can only be done via pattern effects and are one of the things that differentiates Renoise from other sequencers. Examples include: starting to play a sample from the middle (0S effect), then playing it in reverse (0B effect), panning it fully to the left (pan column), pitching it up a bit (0U effect) and finally gliding it down one octave (0G effect). All this can be expressed precisely and easily with the Pattern Editor.

Pattern Effect Columns

Next to the note column(s) are the columns which control volume, panning, delay and pattern effect commands:

By default, the panning and delay columns are not visible. 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 Pattern Editor's control bar, located at the bottom of the editor:

Ticks and Values

To understand how the sample-based effects work, you should understand how Renoise interprets them.

1. Patterns are divided into lines where you can place effects and notes. The Lines Per Beat setting in the Transport Panel defines how many lines make up a musical beat.
2. Ticks divide each line into a smaller fraction. This tick fraction is configurable (Ticks Per Line in the Song Settings), but is a 12th of a line by default.

Many sample commands make use of these ticks, while Automation playback and interpolation are also calculated at the tick rate.

Ticks vs. Note Delays

As noted above, Renoise also has a note delay column, which lets you delay the note to the left of it on the same line. These delays do not use ticks, but instead always divide a line into 256 slices.

Recording and Editing Pattern Effects

Values are entered using the row of numbers above the letters on the keyboard, not the numberpad, which is reserved for quickly switching between instruments in the Instrument Selector. Entering a value will place it at that exact digit in the column. For example, if you are at the first digit in the Volume column and press '8', the value will become '80'. If you want the value to be '08', then move the cursor over to the second digit using the arrow keys and press '8' there.

If you are not yet familiar with the Pattern Editor, then please have a look at the Recording and Editing Notes section of this manual, which provides you with a basic understanding of the pattern editing concepts of Renoise.

Effect Listing

• xx and xy are place-holders whose meanings are explained in the effect command descriptions. They should be replaced with values to create an effect. xx means both digits are one whole value. xy means that the x and y are separate values.

• Effect Column commands are applied to all of the notes in the track to the left of them. If you wish to create effects for specific notes in a track only, use the extra commands available for the volume and panning columns.

• All values noted below are Hexadecimal.

• Similar effect styles are highlighted with the same colour in the Pattern Editor (e.g. pitch up, down and glide are all red, though the exact colour depends on the Theme).

• When typing commands into the Pattern Editor, Renoise will show a small summary about them in the Lower Status Bar.

• Slide commands (pitch/volume/glide) continue to slide up or down by the last valid value if no value (00) is entered. This way you can quickly enter a series of slide commands without having to repeat the same value again and again.

• You can use the small FX drop down menu at the bottom of the Pattern Editor as quick reference:

Effect Column

Sample Commands

Most of the effects listed here only apply to sample-based instruments and will have no effect on MIDI or plugin instruments, as Renoise does not have full control over properties like playback directions, pitch glides etc. The retrigger and delay commands, however, will work with MIDI and plugin instruments.

• 0Axy - Set arpeggio, x/y = first/second note offset in semitones. Using 0 for x or y will use the basenote.
• 0Uxx - Slide pitch up by xx 1/16ths of a semitone (01 is 1/16th of a semitone, 08 is half a semitone, 10 is a whole semitone).
• 0Dxx - Slide pitch down by xx 1/16ths of a semitone (01 is 1/16th of a semitone, 08 is half a semitone, 10 is a whole semitone).
• 0Mxx - Set channel volume level, 00 = -60db, FF = +3db.
• 0Cxy - Cut volume to x after y ticks (x = volume factor, 0 = 0%, F = 100%).
• 0Gxx - Glide towards given note by xx 1/16ths of a semitone (01 is 1/16th of a semitone, 08 is half a semitone, 10 is a whole semitone).
• 0Ixx - Fade volume in by xx volume units (0I01 inserted 256 times will slide from 0 to full volume, 0I7F inserted twice will do the same much faster).
• 0Oxx - Fade volume out by xx volume units.
• 0Pxx - Set track pre-mixer's pan, 00 = full left, 80 = center, FF = full right.
• 0Sxx - Trigger sample slice number xx or offset xx.
• 0Wxx - Set surround width, 00 = min, FF = max.
• 0Bxx - Play sample backwards (xx = 00) or forwards (xx = 01).
• 0Lxx - Set track pre-mixer's volume level, 00 = -INF, FF = +3db.
• 0Qxx - Delay note by xx ticks (00 - TPL). Also QX in Volume and Panning columns.
• 0Rxy - Retrigger note every y ticks with volume x, where x represents:
  • 0 No volume change
  • 1 -1
  • 2 -2
  • 3 -4
  • 4 -8
  • 5 -16
  • 6 *2/3
  • 7 *1/2
  • 8 No change
  • 9 +1
  • A +2
  • B +4
  • C +8
  • D +16
  • E *3/2
  • F *2
• 0Vxy - Set vibrato (regular pitch variation), x = speed, y = depth.
• 0Txy - Set tremolo (regular volume variation), x = speed, y = depth.
• 0Nxy - Set auto pan (regular pan variation), x = speed, y = depth.
• 0Exx - Set active sample envelopes' position to offset xx.
• 0Jxx - Set track's output routing to channel xx, 01 upwards = hardware channels, FF downwards = parent groups (00 is the master track, 01 is the first soundcard output channel and FF is the closest parent group track).
• 0Xxx - Stop all notes and FX (xx = 00), or only effect xx (xx > 00).

Track DSP Commands

You can also change any Track DSP effect parameters with pattern effect commands. The sample commands all start with 0 (e.g. 0G for glide), but Track DSPs also make use the first number to specify which effect in the chain is being altered:

xyzz -> x is the the xth effect in the chain, y is the yth parameter in the device. For example: let's say you have a Filter as the first effect in the DSP effect chain, then 13FF will set the Filter's Resonance to the maximum value (1 = Filter device (the first effect), 3 = Resonance (the third parameter), FF = maximum value).

You can also enable and disable effects with track DSP commands:

• x000 - Turn effect x off.
• x001 - Turn effect x on.

Moving a slider in the Track DSPs panel will also show the pattern effect code in the Lower Status Bar. Right-clicking a slider will automatically record the parameter changes into the Effect Column when Automation recording is set to pattern effects ( - located at the bottom of the Pattern Editor in the control bar).

Global Commands

• ZTxx - Set tempo (BPM) (20 - FF, 00 = stop song)
• ZLxx - Set Lines Per Beat (LPB) (01 - FF, 00 = stop song).
• ZKxx - Set Ticks Per Line (TPL) (01 - 10).
• ZGxx - Toggle song Groove on/off (00 = turn off, 01 or higher = turn on).
• ZBxx - Break pattern. The current pattern finishes immediately and jumps to next pattern at line xx (hex).
• ZDxx - Delay (pause) pattern playback by xx lines.

Volume Column

• 00 - 7F - Set note volume (velocity) of triggering note or set aftertouch value on current playing note (note value should be empty!) in current column (polyphonic after-touch).
• Ix - Volume fade in in the current note column, with step x * 10 (91 = 0I10 in effect column, 92 = 0I20 in effect column etc.)
• Ox - Volume fade out in the current note column, with step x * 10 (A1 = 0O10, A2 = 0O20 etc.)
• Bx - Play sample in the current note column backwards (0 is backwards, 1 is forwards again).
• Qx - Delay a note by x ticks (0 - F).
• Rx - Retrigger a note every x ticks (0 - F).
• Cx - Cut the note after x ticks (0 - F).

Panning Column

• 00 - 80 - Set panning of current note column: (00 = full left, 40 = center, 80 = full right).
• Jx - Panning slide left with step x (0 - F).
• Kx - Panning slide right with step x (0 - F).
• Bx - Play sample in the current note column backwards (0 is backwards, 1 is forwards again).
• Qx - Delay a note by x ticks (0 - F).
• Rx - Retrigger a note every x ticks (0 - F).
• Cx - Cut the note after x ticks (0 - F).

Note: The panning/volume Rx version of retrigger does not restart the sample from the beginning, while the 0Rxy effect command does. This behaviour is intended to give you a choice of two different retrigger modes.

Delay Column

The delay column can only be used to delay note or Note OFF values:

• 40 - 25% delay
  
• 80 - 50% delay
  
• C0 - 75% delay
  

MIDI Commands

With Mx in the panning column and a valid instrument number next to it, you can also send MIDI commands via pattern effects:

--- 0A M0 017F -> will send a control change to the MIDI or plug-in instrument 0A, with control change number 01 and a value of 7F

• M0 - Controller change message (xx = controller number, yy = controller value).
• M1 - Pitch bend (xx main value amount, yy = fine value amount).
• M2 - Program change (yy = program number from 00 - 7F).
• M3 - Channel pressure (monophonic after-touch) (yy = pressure amount).

Note: Insert the Mx MIDI commands in the panning column of the right-most note column, next to the effect column. MIDI commands show a different syntax colour than when they function as panning values and a 0000 value is automatically filled in on the effect column.

Take care that you also add the instrument number, so that Renoise knows which MIDI instrument it should use for the command.

MIDI and plugin instruments can also be Automated through *MIDI Control Devices or *Automation Devices.

Entering Multiple Digit Values with the Computer Keyboard

By default, when entering values with the computer keyboard, Renoise will place a single digit value and immediately move down within the Pattern Editor by the number of lines specified by the Edit Step. If you want to enter multiple digit values in a single line without this occurring between each value entry, this can be achieved by holding down "Left Shift" while entering the values. This works individually with the Volume, Panning, Delay and each of the Effect columns.

Effect Examples

Some very basic sample command examples to get started:

Pitch Slide

1. Pitch slide up [0Uxx]: Sound file (mp3)

From line 00 to 07, the sample is pitched up at a constant rate of 28 (hexadecimal notation), where 00 means "repeat the previous value".

2. Glide to note [0Gxx]: Sound file (mp3)

The first note is played at C-4. At line 04 the pitch rises a constant rate of 20 (hexadecimal notation) towards A-4. Once the glide reaches reaches the desired pitch of A-4, subsequent 0G commands are ignored.

Breakbeat Tricks

Original Loop: Sound file (mp3)

1. Sample offset [0Sxx]: Sound file (mp3)

The offset command works by splitting a sample into 256 equal parts. The larger the sample, the more inaccurate this command will be. As the range of values is 00 to FF, 0S80 plays the sample from halfway through and 0S40 plays the sample from one quarter of the way through.

2. Retrigger note [Rx] : Sound file (mp3)

This effect replays the sample very quickly at its current position in the waveform playback. x sets how many ticks to count before retriggering the sample again. By default, there are 12 ticks per line. Setting R4 will retrigger a sample 3 times per line (12÷4=3).

3. Reverse sample [B0, B1]: Sound file (mp3)

B0 plays the sample backwards from that point. B1 resumes normal playback.

Programming Delays

Here are two techniques for programming a delay:

1. Delay note [Qx]: Qx delays by ticks. A line is divided into equal ticks, the default value being 12. By using the Q8 command in the volume or panning column, the note is delayed by 8 ticks.

2. Using the Delay Column: The Delay Column divides a line into 256 equal parts and so is much more precise than ticks. Use this column to get more accuracy.

Pattern Effects Quick Reference Card

If you can't remember all those commands, here is a small reference card which can be printed out and put next to your monitor.

• Pattern Effects Reference Card