A pattern or song played by a game runs every note through the
scheduler, the instruments and their FX, live. Bake works that out
once, keeps it as a file on the asset, and Play pattern and Play song
play the file instead, as one voice, for as long as nothing it is made
of has changed. The tabs always play live.
- Bake is an icon in the header of the Pattern and the Song tab, lit
while the bake holds. A click bakes, cancels a bake that runs, or
offers Bake again and Remove bake. The toolbar shows the progress.
The info of the tab says "baked" or "bake outdated".
- The bake holds everything up to the output of the pattern or song.
The sound FX of the node, fx params, volume, fade in, bus, Master
routing and stopping with a fade stay live.
- A print of the worked-out plan decides whether it holds: notes and
clips, tempo, length, loop, tracks, the build of each instrument for
each note, sound FX, files, cuts and levels. A rename keeps it, an
undo back to the baked state makes it hold again.
- The file holds the straight run and then one more round of the loop
as heard the second time, tails included. Looped, it plays to the
loop end and then round that round, to the sample. Once, it fades
out over its last 10 ms. Let ring fades it out over 0.3 s.
- It is worked out by a second SoundLibrary on an OfflineAudioContext,
its scheduler woken by suspends of the offline clock, and what
reaches the master is taken. A worklet probe tells whether that was
mono, so a mono bake goes on exactly as the notes did.
- Opus in Ogg, 160 kbit/s stereo or 96 kbit/s mono, encoded with
WebCodecs, the Ogg pages written by hand. Normalized to full scale,
the peak kept and played back.
- The file goes up into the sounds of the account as "[bake] name",
which the sound picker leaves out. An old bake file is deleted once
the project is saved without it. Only a bake that holds is loaded.
- Ogg files are decoded at 48 kHz: resampled to 44.1 kHz, the loop of
a bake lost a sample a round.
- Baking and removing a bake are no undo steps, like the EQ's zoom.
Findings:
- Chrome's AudioEncoder refuses opus.format 'ogg' (NotSupportedError)
but hands out the OpusHead with a pre-skip of 312 for 'opus'.
- The Song tab's header is full at 1280 px: a captioned Bake pushed
Fit off the tab. Hence the icon.
Tests:
- Unit: tests/core/ogg.test.ts (6), tests/core/bake.test.ts (16),
four new in sound-library.test.ts, one in song-play.test.ts. One
test cuts, reverses and fades a clip on a song's track: each change
outdates the bake, each undo makes it hold again.
- e2e 64 (melektaus-atx): ALL PASSED, 36 checks (6 new). Live and baked
rendered offline differ by at most 0.06 dB over 114 windows of
20 ms, two loop ends among them. e2e 65 had no red check with the
icon in its header.
- Gate (melektaus-atx): CHECK EXIT 0, 277 files, 4281 tests.
- Counter-checks: print without instrument builds, print taking the
sound's file instead of the clip's cut, round taken from the first
pass, bake voice without its looping source, Play pattern or Play
song ignoring the bake: one unit test red each. Pre-skip set to 0:
the e2e comparison 4.8 dB off, only that check red.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
adminandClaude Opus 5.5
84cd36f902