12 KiB
effect list
some of the effect numbers are taken from ProTracker / FastTracker 2.
however, effects are continuous (unless specified), which means you only need to type it once and then stop it with an effect value of 00
or no effect value at all.
volume
0Axy
: Volume slide.- if
x
is 0 then this slides volume down byy
each tick. - if
y
is 0 then this slides volume up byx
each tick.
- if
FAxy
: Fast volume slide. same as0Axy
above but 4× faster.F3xx
: Fine volume slide up. same as0Ax0
but 64× slower.F4xx
: Fine volume slide down. same as0A0x
but 64× slower.F8xx
: Single tick volume up. addsx
to volume.F9xx
: Single tick volume down. subtractsx
from volume.
D3xx
: Volume portamento. slides volume toward the new value instead of jumping immediately.x
is the speed of the slide.D4xx
: Volume portamento (fast). same asD3xx
but 256× faster.
07xy
: Tremolo. changes volume to be "wavy" with a sine LFO.x
is the speed.y
is the depth.- tremolo is downward only.
- maximum tremolo depth is -60 volume steps.
D3xx
: Volume portamento. slides the volume to the one specified in the volume column.x
is the slide speed.- a volume must be present with this effect for it to work.
D4xx
: Volume portamento (fast). likeD3xx
but four times faster.
pitch
E5xx
: Set pitch.00
is -1 semitone,80
is base pitch,FF
is nearly +1 semitone.01xx
: Pitch slide up.02xx
: Pitch slide down.F1xx
: Single tick pitch up.F2xx
: Single tick pitch down.
03xx
: Portamento. slides the currently playing note's pitch toward the new note.x
is the slide speed.- a note must be present with this effect for it to work.
- the effect stops automatically when it reaches the new note.
E1xy
: Note slide up.x
is the speed, whiley
is how many semitones to slide up.E2xy
: Note slide down.x
is the speed, whiley
is how many semitones to slide down.
EAxx
: Toggle legato. while on, new notes instantly change the pitch of the currently playing sound instead of starting it over.E6xy
: Quick legato (compatibility). transposes note byy
semitones afterx
ticks.- if
x
is between 0 and 7, it transposes up. - if
x
is between 8 and F, it transposes down.
- if
E8xy
: Quick legato up. transposes note up byy
semitones afterx
ticks.E9xy
: Quick legato down. transposes note down byy
semitones afterx
ticks.00xy
: Arpeggio. this effect produces a rapid cycle between the current note, the note plusx
semitones and the note plusy
semitones.E0xx
: Set arpeggio speed. this sets the number of ticks between arpeggio values. default is 1.
04xy
: Vibrato. makes the pitch oscillate.x
is the speed, whiley
is the depth.- maximum vibrato depth is ±1 semitone.
E3xx
: Set vibrato shape.xx
may be one of the following:00
: sine (default)01
: sine (upper portion only)02
: sine (lower portion only)03
: triangle04
: ramp up05
: ramp down06
: square07
: random08
: square (up)09
: square (down)0a
: half sine (up)0b
: half sine (down)
E4xx
: Set vibrato range in 1/16th of a semitone.
panning
not all chips support these effects.
08xy
: Set panning. changes stereo volumes independently.x
is the left channel andy
is the right one.88xy
: Set rear panning. changes rear channel volumes independently.x
is the rear left channel andy
is the rear right one.81xx
: Set volume of left channel (from00
toFF
).82xx
: Set volume of right channel (from00
toFF
).89xx
: Set volume of rear left channel (from00
toFF
).8Axx
: Set volume of rear right channel (from00
toFF
).
80xx
: Set panning (linear). this effect behaves more like other trackers:00
is left.80
is center.FF
is right.
83xy
: Panning slide.- if
y
is 0 then this pans to the left byx
each tick. - if
x
is 0 then this pans to the right byy
each tick. - be noted that panning macros override this effect.
- if
84xy
: Panbrello. makes panning oscillate.x
is the speed, whiley
is the depth.- be noted that panning macros override this effect.
time
09xx
: Set speed/groove. if no grooves are defined, this sets speed. if alternating speeds are active, this sets the first speed.0Fxx
: Set speed 2. during alternating speeds or a groove, this sets the second speed.
Cxxx
: Set tick rate. changes tick rate toxxx
Hz (ticks per second).xxx
may be from000
to3FF
.
F0xx
: Set BPM. changes tick rate according to beats per minute. range is01
toFF
.
FDxx
: Set virtual tempo numerator. sets the virtual tempo's numerator to the effect value.FExx
: Set virtual tempo denominator. sets the virtual tempo's denominator to the effect value.
0Bxx
: Jump to order.x
is the order to play after the current row.- this marks the end of a loop with order
x
as the loop start.
- this marks the end of a loop with order
0Dxx
: Jump to next pattern. skips the current row and remainder of current order.x
is the row at which to start playing the next pattern.- this can be used to shorten the current order as though it had a different pattern length.
FFxx
: Stop song. stops playback and ends the song.x
is ignored.
note
0Cxx
: Retrigger. repeats current note everyxx
ticks.- this effect is not continuous; it must be entered on every row.
ECxx
: Note cut. triggers note off afterxx
ticks. this triggers key off in FM/hardware envelope chips, or cuts note otherwise.EDxx
: Note delay. delays note byx
ticks.FCxx
: Note release. releases current note afterxx
ticks. this releases macros and triggers key off in FM/hardware envelope chips.E7xx
: Macro release. releases macros afterxx
ticks. this does not trigger key off.
sample offset
these effects make the current playing sample on the channel jump to a specific position. only some chips support this effect.
sample offset is a 24-bit (3 byte) number.
90xx
: Set sample offset (first byte).91xx
: Set sample offset (second byte).92xx
: Set sample offset (third byte).
you may use these effects simultaneously in a row.
if you do not set a byte, its last value will be used.
in previous versions of Furnace a 9xxx
effect existed which set the sample position to $xxx00
(xxx
was effectively multiplied by 256). this maps to 920x 91xx
in current Furnace.
other
EBxx
: Set LEGACY sample mode bank. selects sample bank. used only for compatibility.- does not apply on Amiga.
EExx
: Send external command.- this effect is currently incomplete.
F5xx
: Disable macro.F6xx
: Enable macro.F7xx
: Restart macro.- see macro table at the end of this document for possible values.
additionally, each chip has its own effects.
macro table
ID | macro |
---|---|
00 |
volume |
01 |
arpeggio |
02 |
duty/noise |
03 |
waveform |
04 |
pitch |
05 |
extra 1 |
06 |
extra 2 |
07 |
extra 3 |
08 |
extra A (ALG) |
09 |
extra B (FM) |
0A |
extra C (FMS) |
0B |
extra D (AMS) |
0C |
panning left |
0D |
panning right |
0E |
phase reset |
0F |
extra 4 |
10 |
extra 5 |
11 |
extra 6 |
12 |
extra 7 |
13 |
extra 8 |
operator 1 macros | |
20 |
AM |
21 |
AR |
22 |
DR |
23 |
MULT |
24 |
RR |
25 |
SL |
26 |
TL |
27 |
DT2 |
28 |
RS |
29 |
DT |
2A |
D2R |
2B |
SSG-EG |
2C |
DAM |
2D |
DVB |
2E |
EGT |
2F |
KSL |
30 |
SUS |
31 |
VIB |
32 |
WS |
33 |
KSR |
40 |
operator 2 macros |
60 |
operator 3 macros |
80 |
operator 4 macros |
the interpretation of duty, wave and extra macros depends on chip/instrument type:
ex | FM | OPM | OPZ | OPLL | AY-3-8910 | AY8930 | Lynx | C64 |
---|---|---|---|---|---|---|---|---|
D | NoiseF | NoiseFreq | NoiseFreq | NoiseFreq | Duty/Int | Duty | ||
W | LFO Shape | LFO Shape | Patch | Waveform | Waveform | Waveform | ||
1 | AMD | AMD | Duty | FilterMode | ||||
2 | PMD | PMD | Envelope | Envelope | Resonance | |||
3 | LFOSpd | LFO Speed | LFO Speed | AutoEnvNum | AutoEnvNum | |||
A | ALG | ALG | ALG | AutoEnvDen | AutoEnvDen | Cutoff | ||
B | FB | FB | FB | Noise AND | ||||
C | FMS | FMS | FMS | Noise OR | ||||
D | AMS | AMS | AMS | |||||
4 | OpMask | OpMask | Special | |||||
5 | AMD2 | Attack | ||||||
6 | PMD2 | Decay | ||||||
7 | LFO2Speed | Sustain | ||||||
8 | LFO2Shape | Release |
ex | SAA1099 | X1-010 | Namco 163 | FDS | Sound Unit | ES5506 | MSM6258 |
---|---|---|---|---|---|---|---|
D | Wave Pos | Duty | Filt Mode | FreqDiv | |||
W | Waveform | Waveform | Waveform | Waveform | Waveform | ||
1 | Envelope | EnvMode | WaveLen | Mod Depth | Cutoff | Filter K1 | ClockDiv |
2 | Envelope | WaveUpdate | Mod Speed | Resonance | Filter K2 | ||
3 | AutoEnvNum | WaveLoad W | Control | Env Count | |||
A | AutoEnvDen | WaveLoad P | Control | ||||
B | WaveLoad L | ||||||
C | WaveLoad T | ||||||
D | |||||||
4 | PResetTime | EnvRampL | |||||
5 | EnvRampR | ||||||
6 | EnvRampK1 | ||||||
7 | EnvRampK2 | ||||||
8 | Env Mode |
ex | QSound | SNES | MSM5232 |
---|---|---|---|
D | Echo Level | NoiseFreq | GroupCtrl |
W | Waveform | ||
1 | EchoFeedback | Special | GroupAtk |
2 | Echo Length | Gain | GroupDec |
3 | Noise | ||
A | |||
B | |||
C | |||
D | |||
4 | |||
5 | |||
6 | |||
7 | |||
8 |