A game cannot load and play a sound effect through this library at all #50

New Issue

tachikoma · 2026-08-02T18:33:36-04:00

tachikoma commented

2026-08-02 18:33:36 -04:00

Source: TODO.md, "Found while writing the manual" -> "Defects with no prior entry", item 15 (at bbb7b8f)

akgl_audio_* is a synthesizer that reads no files -- deliberately, and it is
good at what it does: three voices, ADSR, sweeps, a frame-accurate mixer.

akgl_load_start_bgm is the only file-audio entry point in the library, and its
infinite-loop request is set on property set 0, so background music plays once
(filed separately).

Between them there is no way to load a WAV and play it when the player picks up a
coin. SDL3_mixer is vendored and akgl_mixer exists, so the machinery is
present -- what is missing is the four or five akgl_* entry points that expose
it: load a chunk, play it on a free track, stop it, set its volume.

This is the largest single gap in the library's surface for anyone writing an
actual game, and both tutorial games are silent because of it.

Files: src/assets.c, include/akgl/assets.h, src/audio.c

Filed by Tachikoma (Claude Code, Opus 5, 1M context)

**Source:** TODO.md, "Found while writing the manual" -> "Defects with no prior entry", item 15 (at bbb7b8f) `akgl_audio_*` is a synthesizer that reads no files -- deliberately, and it is good at what it does: three voices, ADSR, sweeps, a frame-accurate mixer. `akgl_load_start_bgm` is the only file-audio entry point in the library, and its infinite-loop request is set on property set 0, so **background music plays once** (filed separately). Between them there is no way to load a WAV and play it when the player picks up a coin. `SDL3_mixer` is vendored and `akgl_mixer` exists, so the machinery is present -- what is missing is the four or five `akgl_*` entry points that expose it: load a chunk, play it on a free track, stop it, set its volume. This is the largest single gap in the library's surface for anyone writing an actual game, and both tutorial games are silent because of it. **Files:** `src/assets.c`, `include/akgl/assets.h`, `src/audio.c` --- Filed by Tachikoma (Claude Code, Opus 5, 1M context)

tachikoma added this to the 0.10.0 milestone 2026-08-02 18:33:36 -04:00

tachikoma added the api-gap blast-radius:high labels 2026-08-02 18:33:36 -04:00

tachikoma added the status::grooming label 2026-08-02 18:49:22 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: andrew/libakgl#50