Microaudio Module

A minimal audio module for loading and playing WAV files. Uses the Windows waveOut API directly — zero external dependencies.

Usage

import microaudio.audio

Build with -I modules:

gx myapp.gx -I modules -o myapp.exe

Quick Example

import microaudio.audio

fn main() {
    audio_init()
    defer audio_shutdown()

    var snd = audio_load("explosion.wav")
    if (snd < 0) {
        print("Failed to load sound\n")
        return
    }

    audio_set_volume(snd, 0.8)
    audio_play(snd)
    print("Playing... press Enter to stop.\n")

    input()

    audio_stop(snd)
    audio_free(snd)
}

Initialization

audio_init()          // initialize audio system
defer audio_shutdown() // clean up on scope exit

Loading & Freeing

var snd = audio_load("sound.wav")   // returns sound ID (>= 0) or -1 on error
audio_free(snd)                     // release sound resources

Playback

audio_play(snd)           // play once
audio_play_loop(snd)      // play looping
audio_stop(snd)           // stop playback
audio_stop_all()          // stop all sounds

if (audio_is_playing(snd)) {
    print("Still playing\n")
}

Volume

audio_set_volume(snd, 0.5)          // 50% volume for this sound
var vol = audio_get_volume(snd)

audio_set_master_volume(0.8)         // 80% master volume
var master = audio_get_master_volume()

Platform Notes

• Windows: Uses waveOut API. Links winmm automatically.
• Linux/macOS: Not yet supported (planned: ALSA/CoreAudio backends).
• Supports WAV files only (PCM format).
• Sound IDs are integer handles. Negative return values indicate errors.

Comparison with Raylib Audio

Use microaudio for simple sound effects in standalone GX apps without Raylib. Use Raylib audio for games that already use Raylib, or when you need music streaming and more audio formats.

Module Layout

modules/
  microaudio/
    c/
      microaudio.h       C implementation header
    gx/
      audio.gx           Module API

Example