# Matilde Tracker v1.1 for Buzz

## Introduction

Matilde Tracker is a tracker machine for Buzz which behaves more like Protracker than Jeskola Tracker.

All Protracker effects that make sense in Buzz are implemented and behave in a similar fashion to their Protracker cousins, so you'll feel right at home. The E/xy effects have been renamed to Ex/yy, read on.

Additionally you now have two effects per note, life is sweet!

The machine is a stereo generator, so you need Buzz V1.2 or later to use it. If you're not using 1.2 or stereo is annoying, there's a mono version you can use instead.

Volume envelopes are supported, they take 64 ticks to complete. If this value is undesirable, it can be changed in the machine's attributes. Here you'll also be able to change the volume ramping value.

Have fun,
Carsten Sørensen

## What's new in v1.1?

- Probability command (10)
- Sustain point and note off handled correctly
- Reloading-waves-while-playing crash fixed
- Don't worry, it's compatible with v1.0

## Pattern editor

Column | Description
1 | The note to play
2 | The current wave. If empty, the previously selected wave will be used
3 | Volume. 0=mute, 40=half, 80=full, FE=about double the volume
4 and 6 | Effect to use, see below for description
5 and 7 | Argument to the effect

## Obsolete/changed/ignored effects

Command | Description | Reason
5/xy | Keep tone portamento'ing and do volume slide with argument | Obsolete, there's two effects columns
6/xy | Keep vibrato'ing and do volume slide with argument | Obsolete, there's two effects columns
B/xx | Break to position | Not possible, machines have no control over the songposition
C/xx | Set volume | Replaced by the volume parameter
D/xx | Break to next position, step xx | Not possible, machines have no control over the songposition
E/0x | Set filter state | Not implemented, use a filter machine instead
E/3x | Set glissando | Not implemented
E/43, E/47 | Set vibrato waveform to noise | Not implemented
E/6x | Pattern loop | Not possible, machines have no control over the songposition
E/73, E/77 | Set tremolo waveform to noise | Not implemented
E/Ex | Patterndelay | Not possible, machines have no control over the songposition
E/Fx | Invert loop | Not implemented

## Implemented effects

Command | Argument | Description
00 | xy | Arpeggio On subdivision step 0, the original note will be played. Step one will play the original note+x halftones. Step two will play the original note+y halftones. Step three will restart the process
01 | xx | Slide up xx notches
02 | xx | Slide down xx notches
03 | xx | Tone portamento If xx is zero, keep portamento'ing
04 | xy | Vibrato x - speed y - depth If either is zero, use previous value
05 | xy | Slide panning x - amount to slide panning left y - amount to slide panning right
06 | xy | Autopan x - speed y - depth If either is zero, use previous value
07 | xy | Tremolo x - speed y - depth If either is zero, use previous value
08 | xx | Set panning position 0=left, 80=middle, FF=right
09 | xx | Sample offset xx - offset into sample. Unlike Protracker this is not an absolute offset but scales to the whole length of the sample, ie a value of 80 will start from the middle of the sample. If there's no argument, the sample offset will be set right at the end, useful for E8/01.
0A | xy | Volume slide x - amount to slide volume up y - amount to slide volume down
0F | xx | Subdivide amount This is the same as the Protracker Fxx command, except it doesn't actually change the speed of the song, only the speed of the effects. If the subdivide amount is higher, effects will be updated more often, making them run faster. The default value is 6.
10 | xx | Probability xx - Probability for sample being played. 01=will almost certainly not be played, 80=50%, FF=almost certain
E1 | xx | Fine slide up xx notches
E2 | xx | Fine slide down xx notches
E4 | 0x | Set vibrato type x - 0 - sine, retrig waveform at samplestart x - 1 - saw, retrig waveform at samplestart x - 2 - square, retrig waveform at samplestart x - 4 - sine, don't retrig waveform at samplestart x - 5 - saw, don't retrig waveform at samplestart x - 6 - square, don't retrig waveform at samplestart
E5 | xx | Set finetune for track 00 = -1/2 halfnote, 80 = 0, FF = ~+1/2 halfnote
E6 | 0x | Set panning type See E4/0x for parameter
E7 | 0x | Set tremolo type See E4/0x for parameter
E8 | 01 | Reverse direction of sample being played
E9 | xx | Retrig sample xx - subdivision count at which sample is retriggered
EA | xx | Fine volume slide up
EB | xx | Fine volume slide down
EC | xx | Note cutoff xx - subdivision count at which sample is cut
ED | xx | Note delay Delay samplestart for xx subdivision steps
EE | xx | Fine panning slide left
EF | xx | Fine panning slide right