ts::EffectProgrammer Class Reference

Computes the reverb, chorus and delay coefficient sets from the DLL's own preset tables — the managed re-implementation of the engine's start-up register program. More...

#include <tabulasonora/effect_programmer.hpp>

Static Public Member Functions
static EffectPresets	compute (const RomImage &rom)
	Computes the complete preset set from an open ROM image.
static std::array< std::uint8_t, reverb_row_bytes >	reverb_macro_row (const RomImage &rom, int type)
	The row a macro loads, which is the starting point every individual edit modifies.
static std::array< std::uint8_t, chorus_row_bytes >	chorus_macro_row (const RomImage &rom, int type)
static ReverbPreset	reverb_from_row (const RomImage &rom, std::span< const std::uint8_t > row)
	Recomputes a network from a row, edited or not.
static ChorusPreset	chorus_from_row (const RomImage &rom, std::span< const std::uint8_t > row)
static std::vector< std::array< int, delay_preset_stride > >	read_delay_presets (const RomImage &rom)
	Reads the ten GS delay presets straight out of the DLL's own preset table.

Static Public Attributes
static constexpr int	delay_type_count = 10
	Number of GS delay macros.
static constexpr int	delay_preset_stride = 10
	Bytes per delay preset row.
static constexpr int	reverb_row_bytes = 7
	Bytes in a reverb and a chorus macro row.
static constexpr int	chorus_row_bytes = 8

Detailed Description

Computes the reverb, chorus and delay coefficient sets from the DLL's own preset tables — the managed re-implementation of the engine's start-up register program.

The coefficients were long believed to exist nowhere in the file, because searching for the harvested values (tap 9118, coefficient 0.484375) finds nothing. They are all there — encoded. The engine's effect units are programmed through a register file (param_set_msb / param_set_lsb at 0x18008f340 / 0x18008f4e0), and the programs are data: per-character rows of ring taps stored relative to a base the loader adds (fx_load_dsp_preset at 0x18007f840, base 0x2000 for every GS macro), and coefficient rows in a signed-14-bit floating encoding (fixed14_to_float at 0x180085170). Add the base and decode the fixed point, and every harvested number falls out — verified bit for bit against a live-engine harvest across all eight reverb macros, all eight chorus macros and both GM defaults, with no residual.

The register program itself (fx_apply_reverb_chorus_type at 0x18007f490, chorus_apply_params at 0x180004090) contributes the handful of values that are computed rather than stored: the injection tap from the pre-delay byte, the damping pair from the pre-LPF ladder, the tank feedback gain from the reverb time, and the chorus tap geometry from the macro's delay, rate and depth bytes. Those laws are transcribed here with their float arithmetic intact, so the results carry the same rounding the engine's do.

Every offset is pinned to the SOUND Canvas VA 1.1.6 build, like the rest of the ROM readers.

Member Function Documentation

compute()

EffectPresets ts::EffectProgrammer::compute ( const RomImage & rom )

staticnodiscard

Computes the complete preset set from an open ROM image.

Throws std::runtime_error if a table does not look like the expected data.

reverb_macro_row()

std::array< std::uint8_t, reverb_row_bytes > ts::EffectProgrammer::reverb_macro_row ( const RomImage & rom, int type )

staticnodiscard

The row a macro loads, which is the starting point every individual edit modifies.

chorus_macro_row()

std::array< std::uint8_t, chorus_row_bytes > ts::EffectProgrammer::chorus_macro_row ( const RomImage & rom, int type )

staticnodiscard

reverb_from_row()

ReverbPreset ts::EffectProgrammer::reverb_from_row ( const RomImage & rom, std::span< const std::uint8_t > row )

staticnodiscard

Recomputes a network from a row, edited or not.

Neither reads the row's level byte — reverb [2], chorus [1] — because level is not a coefficient. It does not shape the network, it scales what leaves it, so a caller applying an edited row still has to apply level itself. Forgetting that is silent: the recompute succeeds and the one parameter a file is most likely to set does nothing.

chorus_from_row()

ChorusPreset ts::EffectProgrammer::chorus_from_row ( const RomImage & rom, std::span< const std::uint8_t > row )

staticnodiscard

read_delay_presets()

std::vector< std::array< int, delay_preset_stride > > ts::EffectProgrammer::read_delay_presets ( const RomImage & rom )

staticnodiscard

Reads the ten GS delay presets straight out of the DLL's own preset table.

Member Data Documentation

delay_type_count

int ts::EffectProgrammer::delay_type_count = 10

staticconstexpr

Number of GS delay macros.

delay_preset_stride

int ts::EffectProgrammer::delay_preset_stride = 10

staticconstexpr

Bytes per delay preset row.

reverb_row_bytes

int ts::EffectProgrammer::reverb_row_bytes = 7

staticconstexpr

Bytes in a reverb and a chorus macro row.

A macro does not select a preset that individual edits then sit on top of — it loads these bytes, and the GS addresses 40 01 31-37 and 40 01 39-40 write into the same ones. So a single-parameter edit is a byte in a row followed by a recompute.

chorus_row_bytes

int ts::EffectProgrammer::chorus_row_bytes = 8

staticconstexpr

---

The documentation for this class was generated from the following file:

• include/tabulasonora/effect_programmer.hpp