libs/audio/

libs/audio

Low-Latency Sound Engine & Audio Mixer

A low-latency audio framework built for game engines, desktop apps, and interactive audio workstations. Directly interfaces with Windows WASAPI and CoreAudio to deliver glitch-free sound synthesis, WAV/OGG decoding, and spatial 3D audio panning.

Audio BackendWASAPI / CoreAudio / ALSA

Buffer Latency< 5.3ms Output Delay

Channels64 Mixed Voices

MilestoneActive Module

Protocol & Wire Format Architecture

Zero-Heap Allocation Primitives

Deterministic Memory

Buffer allocations are bound to caller lifecycle with zero heap fragmentation

RFC Wire Conformance

Strict binary packet layout and protocol compliance written in pure Kale

Monorepo Integration

Instantly consumable by Compiler, Editor, and Bare-Metal targets

Architecture Contract

High-Throughput Systems Foundation

Engineered to maximize CPU instruction pipelining and data cache locality. Every algorithm avoids heap pointer indirection wherever contiguous stack or arena buffers can be employed.

Verification: 138/138 Regression Suite Pass

Signed commit governance • Strict type safety

audio_demo.kl

kale

import "libs/audio/engine.kl" as snd;

fn main() -> int32 {
    let engine: snd.AudioEngine = snd.init_engine(44100, 2);
    let sound: snd.Sound = snd.load_wav("assets/chime.wav");
    
    snd.play(&engine, &sound, 1.0, 0.0); // Volume 1.0, Center pan
    snd.sleep_ms(1000);
    
    snd.shutdown(&engine);
    return 0;
}

Compilation & Linker Directives

Deterministic command-line invocations to build, link native dynamic dependencies, and run automated regression tests:

$kale build tests/test_audio.kl -o bin/test_audio.exe -lole32

$./bin/test_audio.exe

Monorepo Governance

GPG Key 1B917D4779A6102E • Continuous integration with automated symbol verification.

Architectural Capabilities

Lock-Free Ring Buffer

High-priority audio thread reads samples without locking or memory allocation stalls.

Multi-Channel Sound Mixer

Dynamic volume, pitch shift, stereo panning, and spatial 3D attenuation for multiple concurrent sounds.

Procedural Synthesizer

Sine, square, triangle, and sawtooth wave generators with ADSR envelope modulation.

← Previous Modulelibs/fs_watch

Next Module →libs/physics