David Whittaker Sound Engine

David Whittaker Sound Engine is a sound driver for the SPC700 programmed by David Whittaker.

Many games have multiple different builds stored in the game at once, sometimes with code differences. Almost every single game has at least one unique build not shared by any of the other games: the exceptions are...

• The opening logos for Lemmings 2: The Tribes and Apocalypse II
• Kick Off 3 Beta's Title Screen and Lawnmower Man/Virtual Wars' US Beta

These are the games where the sound engine was used:

Game Name	Music Version	VCMD Code Location	ROM Offset
Dream TV	0.0 (Beta 2) 2.0 (all other versions)	0x098A (Beta 2) 0x0614 (all other versions)	0x0196A2 (Beta 2, uncompressed) 0x039B16 (all other versions, RNC compressed)
Krusty's Super Fun House	1.0	0x04F1	0x0E8000 (all versions)
Kick Off/Super Kick Off	1.0	0x04E6	0x098000 (all versions)
Batman: Revenge of the Joker	2.0	0x0610	0x068000
Super SWIV/Firepower 2000	2.1	0x06AD	0x158000
Gods	2.2	0x0500/0x0600/0x0612	0x980000/0x98AFAC/0x99D448/0x9A8000 (all versions, three unique build variants, RNC compressed)
World Class Rugby	2.2	0x0608	0x0B8000 (all versions)
Battle Cars	3.0	0x0717	0x0A8000
Chavez/Riddick Bowe Boxing	3.0 (all other versions) 3.1 (Japanese version)	0x0621 (Japanese version) 0x067C (US version) 0x067D (Chavez)	0x0D8000 (all versions)/0x0E8000 (all versions except Chavez) (three unique build variants, one per version between Chavez, US & Japanese versions)
Lawnmower Man/Virtual Wars	3.1	0x06BD (US beta) 0x06A4 (all other versions)	0x9C8000 (all versions except US beta)/0x9E8000 (all versions)
Apocalypse II	3.1	0x05AF/0x0624	0x118000/0x168000
Elite Soccer/World Cup Striker	3.1	0x0601 (US and European version In-Game) 0x060B (US and Japanese version Title Screen) 0x0704 (Japanese version In-Game) 0x070B (European version Title Screen)	0x1B8000 (all versions)/0x08D500 (US & Japanese version)/0x08D550 (European beta version)/0x08D640 (European version) (Four unique build variants: two Title Screen (US/JP compared to EU) and two In-Game (US/EU compare to JP))
Kick Off 3 (Beta version only)	3.1	0x0658/0x06BD	0x1A8000/0x1D8000
Lemmings 2: The Tribes	3.1	0x05AF/0x060F/0x0614/0x0621/0x0697	(omitted for now: there are 16 copies of the code in the ROM, with five different build variants being present: four of them are used in one instance each, that being the opening logo, the Title Screen, the Beach Tribe and the Cavelem Tribe, and the others use a single common copy of the code with modifications of constants and non-code pointers)
Porky Pig's Haunted Holiday (Beta version only)	3.1	0x06CA	(omitted for now: there are 36 copies of the code in the ROM, none of which are unique except for the sound data and modifications of constants and non-code pointers)
Shaq Fu	4.0a	0x0539	0xD96408 (all versions)
Michael Jordan: Chaos in the Windy City	4.0b	0x0539	0xD2B18F (all versions)

Song Entry

For each song entry in an array of song definitions, one byte is defined as a starting tempo, followed by a series of pointers defined little endian style for each channel. For Dream TV Beta and Kick Off, only five pointers are defined. For Krusty's Super Fun House, only six pointers are defined. For all other games, eight pointers are defined.

xx yy yy zz zz aa aa bb bb cc cc dd dd ee ee ff ff

• xx is the starting tempo.
• yy yy is a little endian pointer to a pattern order list for channel 1.
• zz zz is a little endian pointer to a pattern order list for channel 2.
• aa aa is a little endian pointer to a pattern order list for channel 3.
• bb bb is a little endian pointer to a pattern order list for channel 4.
• cc cc is a little endian pointer to a pattern order list for channel 5.
• dd dd is a little endian pointer to a pattern order list for channel 6. (Krusty's Super Fun House only pre-V2.0)
• ee ee is a little endian pointer to a pattern order list for channel 7. (not supported pre-V2.0)
• ff ff is a little endian pointer to a pattern order list for channel 8. (not supported pre-V2.0)

Two builds don't support song entries at all:

• The opening logos for Lemmings 2: The Tribes and Apocalypse II
• Kick Off 3 Beta (In-Game)

Pattern Order List

Each channel has a list of little endian pointers on a per-channel basis. If the pointer is zero, then you jump back to the beginning of the pattern order list for that channel.

Instrument Format

The instrument format at V0.0 is N-SPC/Kankichi-kun compatible minus noise support for SRCN values above 127. Post V1.0, one of the bytes loses its usage.

The instrument format is defined as direct writes to DSP registers for the first four bytes, followed by two pitch-related bytes. They are defined in this order, from top to bottom...

• SRCN
• ADSR1
• ADSR2
• GAIN (unused byte post-V1.0)
• Pitch Base Multiplier
• Pitch Base Fractional Multiplier (in 256ths)

Voice Command Format

VCMD ID	Description	Arguments	Minimum Version
$00-$5F	Note		0.0
$60-$7F	Note Length		0.0
$80-$EC	Invalid		0.0
$ED	Instant Pitch Change to Note	xx	4.0a only
$ED	Set Master Volume	xx	4.0b only
$EE	Volume Scaler by Fraction	xx yy	3.0
$EF	Set ADSR	xx yy	2.0
$F0	Fine Tune	xx	1.0
$F1	Pitch Bend	xx	1.0
$F2	Pitch Envelope ID	xx	0.0
$F3	L/R Voice Volume	xx yy	0.0
$F4	Tempo	xx	0.0
$F5	Jump to Pattern in Order List	xx xx	0.0
$F6-$F7	Invalid		0.0
$F8	Key Off		0.0
$F9	One Note Delay		0.0
$FA	Instrument	xx	0.0
$FB	Absolute Global Transposition	xx	0.0
$FC	Absolute Transposition	xx	0.0
$FD	Invalid		0.0
$FE	Song End		0.0
$FF	Pattern End		0.0

Invalid (VCMDs $80-$EC, $F6-$F7, $FD, $ED (pre-V4.0), $EE (pre-V3.0), $EF (pre-V2.0), $F0-$F1 (pre-V1.0))

The sound driver deliberately freezes itself via an infinite branch always loop rather than crashing or skipping the byte. This also takes up VCMD slots that are not filled in earlier versions.

Note (VCMDs $00-$5F)

Plays a note and delays the channel for one note length.

The initial pitch of the note is calculated using a pitch table that contains one octave (and a note)'s worth of pitch values. This value is shifted according to the octave used, and multiplied that by the instrument's pitch base to get the pitch for the note.

Note Length (VCMDs $60-$7F)

%011xxxxx

• xxxxx represents your note length (as five bits).

Note lengths are defined as the number of tempo ticks plus one. Notes are keyed off either on another note or on the key off VCMD ($F9).

Instant Pitch Change to Note (VCMD $ED)

Requires V4.0a to use. Lower versions freeze the sound driver instead.

$ED xx

• xx defines the note to change the pitch to.

Set Master Volume (VCMD $ED)

Requires V4.0b to use. Lower versions freeze the sound driver instead.

$ED xx

• xx defines the value to directly write to the MVOL DSP registers.

Volume Scaler by Fraction (VCMD $EE)

Requires V3.0 or later to use. Lower versions freeze the sound driver instead.

$EE xx yy

• xx is the numerator, and is the value to multiply the volume by. The scaling process is skipped if this is zero.
• yy is the denominator, and is the value to divide the multiplied volume by.

Put the two together, and you get the current volume multiplied by $x/y$.

Set ADSR (VCMD $EF)

Requires V2.0 or later to use. Lower versions freeze the sound driver instead.

$EF xx yy

• xx is a direct write to the VxADSR1 DSP register.
• yy is a direct write to the VxADSR2 DSP register.

Fine Tune (VCMD $F0)

Requires V1.0 or later to use. Lower versions freeze the sound driver instead.

$F0 xx

• xx is a signed delta value for the pitch. These are in units used directly for the VxPITCH DSP registers.

Pitch Bend (VCMD $F1)

Requires V1.0 or later to use. Lower versions freeze the sound driver instead.

$F1 xx

• xx is a signed delta value for the pitch. These are in units used directly for the VxPITCH DSP registers.

Pitch bends are performed every 10 timer 0 ticks independently of the tempo. They are automatically terminated after one note.

Pitch Envelope ID (VCMD $F2)

$F2 xx

• xx is an index to an array to a pointer of pitch envelopes. The pitch envelopes always loop and are clocked at a rate of 10 timer 0 ticks independently of the tempo ticker.

Pitch Envelope Format

Pitch envelopes are defined using a signed value. These are in units used directly for the VxPITCH DSP registers. If $80 is defined, the envelope loops back to the beginning.

L/R Voice Volume (VCMD $F3)

$F3 xx yy

• This is a direct DSP register write to the VxVOL registers, with xx being the left volume and yy being the right volume.

This VCMD's operation changes depending on the version:

• V0.0-V2.1: Just a straight write with no modifications made to the input.
• V2.2: The input values are shifted left once.
• V3.0-V4.0b: The input values are scaled by VCMD $F3, then shifted left once.
• V4.0a: The input values are scaled by the values used for VCMD $F3. The shifting operation is not done here.

Tempo (VCMD $F4)

$F4 xx

• xx defines one tempo tick as $10*(256/x)$ timer 0 ticks. Zero freezes the song except for pitch bends and envelopes, which are not affected by the tempo ticker.

Jump to Pattern in Order List (VCMD $F5)

$F5 xx xx

• xx xx is a little endian pointer to a pattern pointer in the order list.

Key Off (VCMD $F8)

Keys off the note and delays the channel for one note length.

One Note Delay (VCMD $F9)

Delays the channel for one note length.

Instrument (VCMD $FA)

$FA xx

• xx is an instrument ID to an array of instruments. See Instrument Format above for the format.

Absolute Global Transposition (VCMD $FB)

$FB xx

• xx is a signed note offset to apply for all channels for the music.

Absolute Transposition (VCMD $FC)

$FC xx

• xx is a signed note offset to apply for the channel.

Song End (VCMD $FE)

Terminates the song for all of the channels.

Pattern End (VCMD $FF)

Ends the pattern and goes to the pattern order list to fetch another pattern.