A sound FX played the same every time: its numbers were settings of
the nodes. Now the Input declares parameters with a default, every
number of Gain, Pitch and EQ is an input they can feed, and a Play
sound hands in values for them.
- Input declares number parameters in the inspector, each with a
Default (DeclaredPort.default, SetPortDefaultCommand). They are
outputs of the Input. Input and Output count as terminals now, one
of each per graph.
- Gain, Pitch and EQ take their numbers at inputs under the keys the
settings had, so saved graphs sound as before without a migration.
Each value is held to its range however it arrives.
- The compiler gives an FxPlan with the parameters still open.
fxChainOf fills them in when a voice starts. The player still only
sees an FxChain.
- New behavior node Sound FX parameters: names an FX and picks its
parameters like a Variables node picks variables. Each picked one is
a number input that starts at the FX's default. Its output has the
new port type fxparams, which only fits Play sound's fx params.
- Play sound warns when the parameters name another FX than the one
it plays. Names the FX does not know are left out.
- Renaming a parameter at the Input renames it in every Sound FX
parameters node naming that FX, edges and values included.
- The Sound FX tab has a number field per parameter in its header.
Play uses those values, they are never written into the asset.
- A value counts from the start of a voice. Changing a playing voice
is #315, a Mix node is #316.
Tests:
- soundfx.test.ts 22 (+11): parameters in the plan, held values, a
0-by-default stage, EQ band, save with defaults, wrong port types,
default command with undo, Sound FX parameters into Play sound,
defaults of picked ones, node problems, mismatch, rename with undo
- node-catalog 368 (+3): Play sound fx params, Sound FX parameters
- e2e 34: ALL PASSED - 28 checks (+2: header field plays depth 5,
a Sound FX parameters node gives the game's voice depth 7)
- Gate on melektaus-atx: typecheck, lint, prettier clean, 240 test
files, 3636 tests green
- Counter-check: with fxChainOf ignoring the values and the rename
not followed, 5 of the new tests fail.
- Browser probe: header fields, inspector Default and the picked
parameter looked at in two screenshots.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A sound could only be played as it was uploaded. A Sound FX asset is
a node graph like a shader: Input, effects, Output. Play sound has a
new input fx that sends the voice through it.
- New asset type soundfx ("Sound FX"), not placeable, with a graph
and its own tab. The heading in the asset panel is "Sound effects",
so it does not take the click meant for the + menu entry.
- Nodes in core/soundfx/nodes.ts, category sound, port type audio
that only fits audio: Input, Output, Gain (dB), Pitch (semitones),
EQ (80 Hz and 12 kHz shelves, peaks at 250 Hz, 1 kHz and 4 kHz).
- compileSoundFx walks back from the Output with the shared graph
emitter. An input takes one edge, so the result is one line: a
pitch and a list of gain and filter stages. A node without input
or a graph without Output reports a problem on the node.
- Pitch is the playback rate of the source. It applies to the whole
sound and also changes its length, the node description says so.
- The BehaviorSystem resolves fx and hands the line to the AudioSink.
An fx that is missing or does not compile plays the sound dry.
- SoundLibrary wires source, stages, volume, destination in that
order. stats().last now also names pitch and stage count.
- The tab header picks one of the project's sounds and plays it
through the graph as it stands. Stop there ends only its own voice.
Tests:
- soundfx.test.ts (new, 11), sound-library (9, +2 for the wiring),
node-catalog (+1 for fx), graph and asset-groups adjusted
- e2e 34: ALL PASSED - 26 checks (+5: + menu opens the tab, palette,
2 effects, tab Play and game Play through the FX at -12 st)
- Gate on melektaus-atx: typecheck, lint, prettier clean, 239 of 240
test files green. The red one was sound-library (its fake
AudioContext had no playbackRate), fixed afterwards, gate not
re-run in full.
- Counter-check: without the audio rule in portsCompatible the port
test fails.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
adminandClaude Opus 5.5