TclMixer , by Googie, provides SDL_mixer (SDL) bindings for Tcl. It can allows to play multiple sounds simultaneously using a built-in software mixer.
TclMixer supports following sound formats: WAV/RIFF, MP3, OGG, MID (midi), MOD (including standart MOD modules, but also S3M, IT, XM).
There are basic effects implemented, which would be very useful, such as individual sound volume level, 3D sound source positioning, stereo balance, fading in/out and sound source distance. All these goodies closed in well known, simple Tcl syntax.
To make this extension work, end-user has to got installed SDL [L1 ] (in version 1.2.x) and SDL_mixer [L2 ] (in version 1.2.x), which are quiet famous and presents on most Unix desktop machines (in future tclmixer.so could be linked statically with these libraries to takes dependencies off).
Generaly, it's low-latency alternative for Snack package. It's excellent for a game sound system, but not only.
PYK 2015-10-13: Although test/test.tcl file in the latest release is is outdated and no longer works because tclmixer::setCallback doesn't exist, Tclmixer itself is functional. See examples below that do work.
Get some supported sound file. If it's some effect (gun shot, or explosion or sth) load it as short sound (which gives very low latency):
#!/usr/bin/env wish package require TclMixer set snd [tclmixer::sound file.<mp3|wav|ogg>] tclmixer::play $snd
if file is big (usually some music), then load it as long sound, to prevent loading it into memory:
#!/usr/bin/env wish package require TclMixer set music [tclmixer::music file.<mp3|wav|ogg|mid|mod>] tclmixer::play $music
There is 'wish' used, not 'tclsh', becouse we need some event loop, since SDL_mixer hasn't its own. If you want to use 'tclsh', you need to create some event loop, to let SDL_mixer play whole sound. You can use CALLBACK mechanism:
#!/usr/bin/env tclsh
package require TclMixer
set sleep 0
proc musicFinished {} {
set ::done 1
}
tclmixer::mixConfig -music musicFinished ;# this binds finishing
;# sound playback to call [musicFinished]
set music [tclmixer::music file.<mp3|wav|ogg|mid|mod>]
tclmixer::play $music
vwait ::donePYK 2015-10-13: I've changed this example to use vwait, although TclMixer currently does something funky under the hood, and even setting the vwait variable does result in the script exiting.