summaryrefslogtreecommitdiff
path: root/src/abi.zig
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-17 00:11:20 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitc68a8c9d9efa746e8eaef0392a327888577a05e0 (patch)
treedb903d320e3f4701845af5f07a4ffc5dc9d80ff8 /src/abi.zig
parent896855648c3371ede3c672bbfa75175fa3a1e42e (diff)
downloadsketchbook-c68a8c9d9efa746e8eaef0392a327888577a05e0.tar.gz
sketchbook-c68a8c9d9efa746e8eaef0392a327888577a05e0.zip
audio: a voice's rate (its pitch), and groups of voices under one gain
Voice.rate is the voice's playback speed and so its pitch: 2 is an octave up and half as long, 0 holds it, and changing it does not restart the voice. The mixer keeps a fractional cursor and resamples by linear interpolation between a sample and the next (the last toward silence, or the first when looping): the least code that sounds right, a little dull far from 1; at rate 1 the samples come out exactly. An infinite or NaN rate ends the voice instead of crashing the conversion. Voice.group (0-7) puts a voice under a group's gain, which draw declares each frame with f.gain(group, value) (Command.gain); a group not given one plays at 1, so it is declared state and replays like the voices. The mixer glides each group toward its gain by 1/480 a sample (10 ms for a full swing), so a gain set in one step does not click. Music ducking under speech is then the sketch lowering one number; nothing ducks by itself. The web host ignores gains as it ignores voices. Test: half and double speed against the interpolated samples, rate 0 holding, an infinite rate ending; a looping voice in group 1 at gain 0.5 gliding there and staying while group 0's is untouched, and going back to 1 when the gain is no longer declared. test-audio also builds the voices sketch for the web, which compiles the web host's newSound and gain. The README lists rate, group and f.gain with what they do. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'src/abi.zig')
-rw-r--r--src/abi.zig8
1 files changed, 8 insertions, 0 deletions
diff --git a/src/abi.zig b/src/abi.zig
index 3c47e69..35c399b 100644
--- a/src/abi.zig
+++ b/src/abi.zig
@@ -303,6 +303,11 @@ pub const Voice = struct {
volume: f32 = 1,
/// Linear fade at both ends, in samples.
fade: u32 = 0,
+ /// Playback speed, as pitch: 2 is an octave up and half as long, 0
+ /// holds it. Changing it does not restart the voice.
+ rate: f32 = 1,
+ /// Whose gain (`Command.gain`) also scales it: music, speech, effects.
+ group: u3 = 0,
};
/// Slices must stay alive until the host consumes the frame, right after
@@ -372,6 +377,9 @@ pub const Command = union(enum) {
voice: Voice,
/// Mono samples at `Input.sample_rate` for stream `key`.
audio: struct { key: u32, samples: []const f32, clear: bool = false },
+ /// The gain of a group of voices (`Voice.group`) this frame; a group
+ /// not given one plays at 1. Declared like a voice, so it replays.
+ gain: struct { group: u3, gain: f32 },
/// RGBA8 rows of `w * 4` bytes into an image made by `Host.newImage`.
pixels: struct { image: Image, w: u32, h: u32, rgba: []const u8, premultiplied: bool = false },
/// Renders a GPU pass into an image made by `Host.newImage`, when