Music sequence - Revision history

Tenry: Add example melody script.

2025-12-05T18:08:24Z

Add example melody script.

Show changes

Tenry: Use #include syntax for manual sequence format

2025-11-21T20:01:18Z

Use #include syntax for manual sequence format

Tenry: add formular for calculating tick length

2020-11-10T12:44:45Z

add formular for calculating tick length

Tenry at 17:30, 8 November 2020

2020-11-08T17:30:43Z

Tenry: add note properties

2020-11-08T06:04:03Z

add note properties

Tenry at 22:58, 7 November 2020

2020-11-07T22:58:42Z

Tenry at 22:44, 7 November 2020

2020-11-07T22:44:55Z

Tenry: add list of notes

2020-11-07T22:22:14Z

add list of notes

Show changes

Tenry: Cleanup

2020-11-07T22:10:04Z

Cleanup

Show changes

Tenry at 22:08, 7 November 2020

2020-11-07T22:08:23Z

Show changes

@@ Line 507: / Line 507: @@
 === Manually ===
-Sequence files can also be created manually in a textual format. Create a new assembly file in the sequences directory, for example '''sound/sequences/us/23_custom_sequence.s'''. This file should begin with the following header:<syntaxhighlight>
+Sequence files can also be created manually in a textual format. Create a new assembly file in the sequences directory, for example '''sound/sequences/us/23_custom_sequence.s'''. This file should begin with the following header:<syntaxhighlight lang="asm">
-.include "seq_macros.inc"
+#include "seq_macros.inc"
 .section .rodata
 .align 0

@@ Line 423: / Line 423: @@
 == Note durations ==
-The effective duration of a note and the delay commands is based on the currently set sequence tempo.
+The effective duration of a note and the delay commands is based on the currently set sequence tempo. The duration of a single tick in seconds can be calculated using the following formular: <code>time = 1.25 / tempo</code>.
 {| class="wikitable"
 !Note
 !Ticks
 |-
 |whole
 |192
 |-
 |half dotted (2nd + 4th)
 |144
 |-
 |half
 |96
 |-
 |quarter dottet (4th + 8th)
 |72
 |-
 |quarter (4th)
 |48
 |-
 |eighth dottet (8th + 16th)
 |36
 |-
 |quarter tuplet
 |32
 |-
 |eighth (8th)
 |24
 |-
 |sixteenth dottet (16th + 32th)
 |18
 |-
 |eigthth tuplet
 |16
 |-
 |sixteenth (16th)
 |12
 |-
 |32th dottet (32th + 64th)
 |9
 |-
 |sixteenth tuplet (16th)
 |8
 |-
 |32th
 |6
 |-
 |32th tuplet
 |4
 |-
 |64th
 |3
 |-
 |64th tuplet
 |2
 |}

← Older revision		Revision as of 17:30, 8 November 2020
Line 1,333:		Line 1,333:
	* [https://www.smwcentral.net/?p=section&s=sm64music Custom music] for SM64 on SMW Central		* [https://www.smwcentral.net/?p=section&s=sm64music Custom music] for SM64 on SMW Central
	* [https://hackmd.io/opEB-OmxRa26P8h8pA-x7w m64 format] posted on HackMD		* [https://hackmd.io/opEB-OmxRa26P8h8pA-x7w m64 format] posted on HackMD
		+	[[Category:Audio]]

@@ Line 4: / Line 4: @@
 A sequence is played as long as the sequence script is not ended. A channel (including layers) is active as long as the channel script is not ended.
 == List of notes ==
@@ Line 410: / Line 425: @@
 The effective duration of a note and the delay commands is based on the currently set sequence tempo.
 {| class="wikitable"
 !Note
 !Ticks
@@ Line 698: / Line 712: @@
 === Channel commands ===
 {| class="wikitable"
 !Mnemonic
 !Param 1
@@ Line 1,115: / Line 1,128: @@
 === Layer commands ===
 {| class="wikitable"
 !Mnemonic
 !Param 1
@@ Line 1,274: / Line 1,286: @@
 |duration
 |0x00-0x3f, var, u8, u8
-|Play note with play percentage X, velocity Y, duration Z and pitch N. (Is “play percentage” the right term?). Only valid if channel is set to “large notes”.
+|Play note with specified pitch, percentage, velocity and duration. Only valid if channel is set to “large notes”.
 |-
 !layer_note1
@@ Line 1,282: / Line 1,294: @@
+|
 |0x40-0x7f, var, u8
-|Play note with play percentage X, velocity Y, duration 0 and pitch N. Only valid if channel is set to “large notes”.
+|Play note with specified pitch, percentage and velocity and duration of 0. Only valid if channel is set to “large notes”.
 |-
 !layer_note2
 |velocity
 |duration
+|
 |0x80-0xbf, u8, u8
-|Play note with velocity X, duration Y, pitch N and the last used play percentage. Only valid if channel is set to “large notes”.
+|Play note with specified pitch, velocity and duration. Only valid if channel is set to “large notes”.
 |-
 !layer_smallnote0
@@ Line 1,298: / Line 1,310: @@
+|
 |0x00-0x3f, var
-|Play note with play percentage X and pitch N, with velocity and duration taken from the short notes settings set by setshortnote{velocity,duration} (or the fromtable variants), defaulting to 0 and 0x80 respectively if not set. Only valid if channel is set to “small notes”.
+|Play note with specified pitch and percentage and velocity and duration set with layer_setshortnotevelocity and layer_setshortnoteduration. Only valid if channel is set to “small notes”.
 |-
 !layer_smallnote1
@@ Line 1,306: / Line 1,318: @@
+|
 |0x40-0x7f
-|Play note with pitch N and the default play percentage, as set by setshortnotedefaultplaypercentage (there is no built-in default; using it without that command will read uninitialized memory). Velocity and duration is set like in smallnote0. Only valid if channel is set to “small notes”.
+|Play note with specified pitch and the default play percentage, as set by layer_setshortnotedefaultplaypercentage (there is no built-in default; using it without that command will read uninitialized memory). Velocity and duration is set like in layer_smallnote0. Only valid if channel is set to “small notes”.
 |-
 !layer_smallnote2
@@ Line 1,314: / Line 1,326: @@
+|
 |0x80-0xbf
-|Play note with pitch N and the previous play percentage. Velocity and duration is set like in smallnote0. Only valid if channel is set to “small notes”.
+|Play note with specified pitch and the previous play percentage. Velocity and duration is set like in layer_smallnote0. Only valid if channel is set to “small notes”.
 |}

@@ Line 1: / Line 1: @@
 dasdasdasdMusic in Super Mario 64 is controlled by sequence files. They are in .m64 format, which is similar to [[wikipedia:MIDI|MIDI]]. A sequence file has a sequence script, that can spawn channels, which have channel scripts, that can spawn layers (also known as tracks), which have layer scripts that can play notes. Each note is performed using an instrument from a sound bank. A sequence file can use multiple banks. The mapping from sequences to sound banks is described in '''sound/sequences.json'''. Channels can switch between banks using a command. However, in practice most sequences limit themselves to a single sound bank. The main exception is sequence 0, which is responsible for sound effects.
-A sequence may play up to 16 channels with up to 4 layers per channel.
+A sequence may play up to 16 channels with up to 4 layers per channel. Several notes can be played simultaneously on a single layer.
 == List of notes ==

@@ Line 403: / Line 403: @@
 |0x7F
 |0xBF
 |}