mirror of https://github.com/bryanthaboi/gen1recomp synced 2026-09-26 13:33:27 -04:00

Files

T

1jamie 52ad498b8b feat(game3): self-contained ROM-derived FireRed extraction & cache contract alignment

- Align CacheContract firered overrides with pure ROM extraction
- Fix door animation extraction tile sizes, palettes, and strides
- Update storage chrome, pokedex, summary, and battle chrome extractors
- Ensure 100% self-contained ROM extraction without external dependencies

2026-09-09 14:14:40 -05:00

1.6 KiB

Raw Permalink Blame History

Game3 (FireRed) audio

Self-contained M4A/MP2K path: Lua extract during ROM import, in-process player at runtime. No Python, ffmpeg, or host CLI.

Extract

src/import/gba/extract_audio.lua (Intro+Audio stage) writes:

data/generated/gba/audio/
  meta.json index.lua songtable.bin
  samples.bin samples.lua
  cries.lua crytable.bin
  songs/<id>.bin

DirectSound PCM is stored as raw s8. WaveData.type 1 is GameFreak DPCM — the extractor decompresses it to linear s8 (agbplay-compatible). Playing compressed bytes as PCM sounds shrieky/garbled.

Offsets for FireRed USA 1.0 are in Versions.AUDIO (song_table, cry_table). The extractor also structurally scans for gSongTable if needed.

Runtime

Module	Role
`game3/audio.lua`	Numeric ID API (`playSong` / `playSe` / `playCry` / fanfare / map)
`m4a_sample.lua`	s8 → SoundData
`m4a_mix.lua`	DirectSound + CGB (ChipSynth-compatible oscillators)
`m4a_seq.lua`	Track bytecode; GOTO = loop
`m4a_player.lua`	Pack load + 4 players
`m4a_worker.lua`	Lock-free BGM buffer pump (`love.thread` Channels)

Install uses explicit root data/generated/gba/audio (never Sevii Extract.CACHE_ROOT).

Manual check

Import FireRed → cache has samples.bin / index.lua
Title / boot SE_SELECT (5)
Oak / mon pic cry
Start menu open/move/confirm SE
Field map BGM on enter; warp keeps or changes song
Wild battle BGM → victory → map restore
Level-up fanfare blocks waitfanfare

Dev A/B (optional)

Desktop-only comparison against agbplay is fine for tuning. Never required for user import.

1.6 KiB Raw Permalink Blame History