10. Reference tables

Everything needed to reimplement the pipeline, plus an index into the decomp.

The character → voice code table

mMsg_sound_voice_get's full 256-byte array, indexed by the game character code (row × 16 + column). 0x7F and 0x80 hold 0xFF but the function returns −1 for them before the lookup.

      x0 x1 x2 x3 x4 x5 x6 x7 x8 x9 xA xB xC xD xE xF
0x00  85 85 5D 5D 5D 5D 5D 5D 5F 61 61 61 61 65 65 65
0x10  65 60 6A 6B 6B 6B 6B 6B 85 71 71 71 71 5E 6C 5D
0x20  81 83 85 5D 5D 85 85 85 85 85 85 85 85 85 85 80
0x30  53 54 55 56 57 58 59 5A 5B 5C 85 85 85 85 85 82
0x40  85 5D 5E 5F 60 61 62 63 64 65 66 67 68 69 6A 6B
0x50  6C 6D 6E 6F 70 71 72 73 74 75 76 5D 85 5D 5D 85
0x60  5F 5D 5E 5F 60 61 62 63 64 65 66 67 68 69 6A 6B
0x70  6C 6D 6E 6F 70 71 72 73 74 75 76 61 61 61 61 FF
0x80  FF 65 65 65 65 86 60 6A 6B 6B 6B 6B 6B 85 71 71
0x90  85 71 71 75 75 6C 75 85 85 5D 6B 85 85 85 85 85
0xA0  85 85 85 85 85 85 85 85 85 85 85 85 85 85 85 85
0xB0  85 85 85 85 85 85 85 85 85 85 85 85 85 85 85 85
0xC0  85 85 85 85 85 85 85 85 85 85 85 85 85 85 85 85
0xD0  85 85 81 81 85 85 85 85 85 85 85 85 85 85 85 85
0xE0  85 85 85 85 85 85 85 85 85 85 85 85 85 85 85 85
0xF0  85 85 85 85 85 85 85 85 85 85 85 85 85 85 85 81

Source: src/game/m_msg_sound.c_inc:2, verified verbatim.

Voice codes

Code	Char	Class
`0x53`–`0x5C`	`0`–`9`	2 (neither)
`0x5D` `0x61` `0x65` `0x6A` `0x6B` `0x71`	`a e i n o u`	0 (vowel)
other of `0x5D`–`0x76`	`b c d f g h j k l m p q r s t v w x y z`	1 (consonant)
`0x80`–`0x86`, `0xFF`	♪ ␣ ? ! ⏎ mute click empty	2 (neither)

Letter L ↔ code: 0x5D + (L − 'a'). Digit D ↔ code: 0x53 + D.

Phoneme codes

Phoneme code v plays soundfont instrument v − 1. Code 0 is silence. Codes marked † are produced by more than one rule and therefore share a sample.

Short vowels (`Sou_TanboinHenkan`)

`a`	`i`	`u`	`e`	`o`	`n`
0x01	0x14	0x29	0x0A	0x1D	0x1B

Long vowels (`Sou_ChouboinHenkan`)

`a`	`i`	`u`	`e`	`o`	`n`
0x02 †	0x15 †	0x2A †	0x0E †	0x1E	0x1B

Used only when class(a) == vowel && class(b) == consonant && c == 'e'. The tables are otherwise byte-identical.

Consonants (both tables)

Letter	Code	Notes
`b`	0x07
`c`	0x23 / 0x18	soft (= `s`) if next letter is `i` or `e`, else hard (= `k`)
`d`	0x09
`f`	0x11
`g`	0x12
`h`	0x00	silent — no instrument
`j`	0x17	shares `ge`
`k` `q`	0x18
`l`	0x19
`m`	0x1A
`p`	0x21
`r`	0x22
`s`	0x23
`t`	0x26	shares digit `2`
`v`	0x2D
`w`	0x2E
`x`	0x31	shares `ks`
`y`	0x15	shares long `i` and `ea`
`z`	0x30

Digits (both tables)

`0`	`1`	`2`	`3`	`4`	`5`	`6`	`7`	`8`	`9`
0x32	0x33	0x26	0x27	0x34	0x35	0x36	0x37	0x10	0x38

Digraphs (`Sou_ConnectCheck`) — 53 entries

Pair	Code	Pair	Code	Pair	Code	Pair	Code
`ai`	0x0F	`go`	0x3E	`no`	0x49	`si`	0x36
`al`	0x02	`ha`	0x3F	`of`	0x4A	`so`	0x4F
`an`	0x39	`he`	0x40	`oh`	0x4B	`su`	0x25
`ar`	0x16	`hi`	0x41	`ok`	0x4C	`th`	0x28
`as`	0x3A	`ho`	0x42	`on`	0x4D	`to`	0x50
`be`	0x3B	`i␣`	0x05	`oo`	0x2A	`up`	0x51
`by`	0x3C	`if`	0x43	`or`	0x2C	`we`	0x52
`ch`	0x08	`in`	0x44	`ou`	0x20	`wo`	0x33
`do`	0x3D	`ir`	0x0C	`ow`	0x06	`you`	0x77
`ea`	0x15	`is`	0x45	`oy`	0x1F	`ze`	0x32
`er`	0x0D	`it`	0x46	`re`	0x0E
`fa`	0x35	`ks`	0x31	`se`	0x37
`fo`	0x34	`me`	0x47	`sh`	0x24
`ge`	0x17	`my`	0x48	`na`	0x38
		`ng`	0x1C

Of the 119 codes 0x01–0x77, the phonology engine produces 76. The 43 it never produces are seven isolated gaps — 0x03 0x04 0x0B 0x13 0x2B 0x2F 0x4E — plus the 36-code block 0x53–0x76. The anti-repetition substitution can reach the first six of the gaps (it only emits 0x00–0x3F); the block is reachable only via the editor path; 0x4E appears to be reachable by nothing at all.

Specs

Spec	Seq	Bank	Vol	Pitch	Speaker
2	243	156	0.65	1.00	lazy & jock villagers; most special NPCs (default)
3	244	157	0.65	1.00	cranky villagers; Wendell, Pete, Booker, Jack
4	245	158	0.65	1.00	normal, peppy, snooty villagers; Pelly, Phyllis, Mabel, Sable, Blanca; event narration
5	243	156	0.90	1.00	player, male — text editor only
6	245	158	0.90	1.00	player, female — text editor only
7	243	156	0.90	1.30	Timmy & Tommy (via control code 93)
8	245	158	0.90	0.75	Joan
9	243	156	0.70	0.65	Farley

Per-code playback parameters

What each phoneme code actually plays — instrument, semitone, note delay, velocity, per sequence — is tabulated on the disc page, extracted from the shipped sequence data. The headline constants: dialogue phonemes play at semitone 44 (seq 243), 41/39 (seq 244) or 39 (seq 245) against unity-at-48 (PITCHTABLE[i] = 2^((i−48)/12)), velocity 110 (gain (110/127)² ≈ 0.75); editor letter names at semitone 44 with a rising sweep from 41, velocity 95; all samples tuned 0.689062 = 22050/32000.

Disc image quick reference (GAFE01 USA rev 0)

Thing	Where
main DOL	disc `0x1E000` (from header `0x420`)
FST	disc `0xFE500`, size `0x102` (from header `0x424/0x428`)
`/audiorom.img`	disc `0x626D10`, size `0x7EA760`
the five audio tables	DOL `.data5`; VAs `0x800CCA40` (seq), `0x800CD9E0` (bank), `0x800CE3E0` (wave), `0x800CE450` (data), `0x800CE490` (map)
seq 243 / 244 / 245	disc `0x6D2770` / `0x6D2DD0` / `0x6D3250`, sizes `0x660` / `0x480` / `0x660`
bank 156 / 157 / 158	disc `0x752670` / `0x756B70` / `0x759B90`
wave bank 5	disc `0xA23E50`, size `0x3ED620`; `smzwavetable.sample` is relative to this

Full derivations, structure layouts and the VADPCM decoder are on the disc page.

Text control codes that affect voice

Value	Name	Effect
3	`CURSOR_SET_TIME`	pauses the cursor; lets a half-built window fire early
75–79, 97	`SET_MESSAGE_CONTENTS_*`	emotion state (normal / angry / sad / fun / sleepy / gloomy)
81	`SOUND_CUT`	plays system SE `0x54`, sends the end code, suppresses voice
84	`SET_CHAR_SCALE`	changes glyph scale → the volume step
90	`SET_LINE_SCALE`	same, per line
92	`VOICE_TRUE`	restore spec (Timmy/Tommy only)
93	`VOICE_FALSE`	spec 7 (Timmy/Tommy only)

Source index

Paths relative to the ac-decomp root. Line numbers are for commit 09ca8e8b.

Message layer

`src/game/m_msg_sound.c_inc:1`	`mMsg_sound_voice_get` — the 256-entry table
`:26`	`mMsg_sound_voice_get_for_editor`
`:44`	`mMsg_sound_voice_get2` — newline injection
`:52`	`mMsg_check_sound_special` — forced-voice message ranges
`:66`	`mMsg_check_sound_animal`
`:85`	`mMsg_sound_voice_entry` — the (a, b, c) window
`:117`	`mMsg_sound_voice_endcode_set`
`:126`	`mMsg_sound_CodeVoice`
`:259`	`mMsg_sound_voice_mode_get`
`:288`	`mMsg_sound_spec_change_voice_force`
`:317`	`mMsg_sound_spec_change_true/false` — Timmy/Tommy
`src/game/m_msg_cursol.c_inc:1100`	`mMsg_Main_Cursol_ControlCursol` — the cursor loop
`:1184`	the `NOT_PAUSE_FRAME` toggle
`src/game/m_msg_draw_font.c_inc:35`	voice-fire decision
`src/game/m_font_main.c_inc:951`	`mFontSentence_animal_voice_se` — scale, and the call
`:1078`	the draw-loop trigger
`src/game/m_npc.c:32`	`l_sp_actor_name` — special-NPC spec table
`:4116`	`mNpc_GetNpcSoundSpec`
`src/game/m_submenu.c:364`	player voice, specs 5 / 6
`src/game/m_editor_ovl.c:712`	the mode-1 editor path

Bridge

`src/audio.c:96`	`sAdo_VoiceSe`
`:152`	`sAdo_SetVoiceMode`
`:216`	`sAdo_SpecChange`
`include/audio.h:45`	`VOICE_STATUS_*`
`include/audio_defs.h:10`	`VOICE_MODE_*`

Audio engine — `src/static/jaudio_NES/game/game64.c_inc`

`:22`	`VOICE_GROUP` = `NA_GROUP4`
`:97`	`SOU_VOICE_SE` struct
`:236`	`SHIIN2BOIN` (dead)
`:311`	`sou_voice_se_init` — pan `0x3F`, reverb 0
`:820`	`Sou_VoiceStart`
`:1174`	`Sou_VoiceMake`
`:1708`	`Sou_SpecialRoutine10` — deferred syllable
`:1852`	`Na_GameFrame`
`:2146`	`Sou_TanboinHenkan`
`:2231`	`Sou_ChouboinHenkan`
`:2316`	`Sou_ConnectCheck`
`:2564`	`Sou_BoinShiinCheck`
`:2598`	`Na_VoiceSe`
`:3319`	`Na_SetVoiceMode`
`:3459`	`Na_SpecChange`
`melody.c:727`	`Na_MelodyVoice` — the ♪ handler
`audioheaders.c:4073`	bank 156–158 entries
`audioheaders.c:4176`	`AudiodataHeaderStart` — the three archives
`audioheaders.c:4717`	seq 243–245 → bank 156–158

Soundfont / bank loading

`include/jaudio_NES/audiostruct.h:74`	`ArcEntry` / `ArcHeader`
`:95`	`adpcmloop`, `adpcmbook`, `smzwavetable`, `wtstr`
`:348`	`voicetable` — the instrument
`:373`	`voiceinfo` — per-bank runtime info
`src/static/jaudio_NES/internal/system.c:772`	`__Link_BankNum` — alias entries
`:813`	`Nas_BankOfsToAddr_Inner` — offset → pointer
`:1171`	`__SetVlute` — `param0/1/2` decode
`:1692`	`__WaveTouch` — sample vs bank relocation
`internal/channel.c:354`	`NoteToVoice`
`:368`	`ProgToVp` — instrument index → `voicetable`
`internal/track.c:1159`	`Nas_ProgramChanger`
`:1399`	`SUBTRACK_CMD_SET_INSTRUMENT_BANK` — reverse bank-list index

Sequence playback internals

`include/jaudio_NES/audiocommon.h:405`	common / group / subtrack / note command opcodes
`internal/track.c:543`	`Nas_NoteSeq` — note layer interpreter
`:1028`	`__SetNote` — note byte → semitone/delay/velocity
`:780`	`__SetVoice` — `frequency_scale = PITCHTABLE[semitone] × tuning`, portamento
`:1746`	`MACRO_READ_PORT0` — destructive port read (resets to −1)
`:1877`	`GRP_CMD_SET_TEMPO` — tempo = byte × 48 tatums
`internal/audiotable.c:321`	`PITCHTABLE` — `2^((i−48)/12)`, unity at 48
`internal/memory.c:998`	`max_tempo` derivation (tick rate)
`internal/audioconst.c:32`	`AGC` — `timeBase = 48`
`internal/dummyrom.c:68`	`Jac_InitARAM` — opens `/audiorom.img`
`internal/neosthread.c:56`	`DVDT_LoadtoARAM("/audiorom.img", …)`