• Stars
    star
    168
  • Rank 224,790 (Top 5 %)
  • Language
    C
  • License
    MIT License
  • Created over 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Portable ANSI C audio mixer for games

cmixer

A lightweight, portable ANSI C audio mixer for games.

Features

  • Easy to use
  • Tiny: two files, around 600sloc
  • No dependencies (stb_vorbis is optional)
  • Support for wav and ogg files if stb_vorbis is used
  • Simple API for adding custom formats
  • Resampling and seamless looping
  • Per-source gain, pan and pitch control
  • Fast, fixed-point internal processing

Getting Started

The library's .c and .h files can be dropped into a project and compiled along with it. If ogg vorbis support is desired stb_vorbis.c should also be added to the project and the -DCM_USE_STB_VORBIS flag passed to the compiler.

Before use, the library should be initialized with the desired samplerate:

cm_init(44100);

A sound can be played by first creating a source, then calling cm_play() on that source.

cm_Source *src = cm_new_source_from_file("sound.wav");
cm_play(src);

When the cm_process() function is called, all the currently playing streams will be processed and mixed, the master output will be written to the provided 16bit buffer. This output is always stereo interlaced, thus the buffer length must always be an even number:

cm_Int16 buffer[512];
cm_process(buffer, 512);

cm_process() can safely be called from a separate thread; if more than one thread is used a lock event handler must be set:

static void lock_handler(cm_Event *e) {
  if (e->type == CM_EVENT_LOCK) {
    printf("acquired lock\n");
  }
  if (e->type == CM_EVENT_UNLOCK) {
    printf("released lock\n");
  }
}

cm_set_lock(lock_handler);

See doc/api.md for an overview of the API or demo for usage demos.

License

This library is free software; you can redistribute it and/or modify it under the terms of the MIT license. See LICENSE for details.

More Repositories

1

lite

A lightweight text editor written in Lua
Lua
7,287
star
2

microui

A tiny immediate-mode UI library
C
3,124
star
3

log.c

A simple logging library implemented in C99
C
2,472
star
4

json.lua

A lightweight JSON library for Lua
Lua
1,734
star
5

dyad

Asynchronous networking for C
C
1,437
star
6

fe

A tiny, embeddable language implemented in ANSI C
C
1,277
star
7

lume

Lua functions geared towards gamedev
Lua
945
star
8

classic

Tiny class module for Lua
Lua
799
star
9

lovedos

A framework for making 2D DOS games in Lua
C
666
star
10

map

A type-safe hash map implementation for C
C
558
star
11

vec

A type-safe dynamic array implementation for C
C
436
star
12

microtar

A lightweight tar library written in ANSI C
C
423
star
13

flux

A fast, lightweight tweening library for Lua
Lua
366
star
14

lite-plugins

Plugins for the lite text editor
Lua
346
star
15

ini

A tiny ANSI C library for loading .ini config files
C
315
star
16

log.lua

A tiny logging module for Lua
Lua
296
star
17

lovebird

A browser-based debug console for LÖVE
Lua
286
star
18

lurker

Auto-swaps changed Lua files in a running LÖVE project
Lua
268
star
19

kit

A tiny library for making small games with big pixels
C
240
star
20

aq

A lightweight framework for creating audio toys
C
236
star
21

uuid4

A tiny C library for generating uuid4 strings
C
214
star
22

sfd

A small C library for opening a file dialog
C
171
star
23

sandbird

A tiny embeddable HTTP server written in C89
C
169
star
24

aria

A tiny, embeddable lisp-shaped language implemented in C89
C
166
star
25

juno

Framework for making 2D games with chunky pixels in Lua
C
160
star
26

tick

Lua module for delaying function calls
Lua
123
star
27

dmt

Dynamic memory tracker for C
C
105
star
28

autobatch

Small LÖVE module to automate the use of SpriteBatches
Lua
103
star
29

lite-colors

Colors themes for the lite text editor
Lua
99
star
30

cembed

A small utility for embedding files in a C header
C
93
star
31

doq

A small tool for creating single-file html documents
C
82
star
32

lovebpm

A LÖVE library for syncing events to the BPM of an audio track
Lua
76
star
33

coil

A tiny cooperative threading module for Lua
Lua
71
star
34

shash

A simple, lightweight spatial hash for Lua
Lua
66
star
35

console

A console plugin for the lite text editor
Lua
58
star
36

atlas

A small utility for generating a texture atlas
C
41
star
37

gifwriter

A Nim library for writing animated GIFs
C
18
star
38

rxi.github.io

HTML
17
star
39

cmixer_sdl2-nim

Tiny Nim library for using cmixer with sdl2
Nim
3
star
40

cmixer-nim

Nim wrapper for cmixer, A lightweight audio mixer for games
C
3
star
41

crate

2
star