1
Release notes for the sndkit collection
2
=======================================
4
This directory contains the sources for a set of utilities
5
included in the OSS package. In addition there is an unsorted collection
6
of many kind of programming experiments. Some of them don't even work.
8
We have released these sources just because there is no reason to not to
9
release them. We hope that somebody finds them interesting.
11
There is no documentation available for these sources at this moment. They
12
will be officially released at the some time with OSS 4.0. Most of the files
13
are created to test recent OSS versions os they will not work with older
14
implementations such as the kernel freeware OSS drivers (OSS/Free) or
17
Some of these programs do things that are not necessary in majority of
18
OSS applications. Please refers to the OSS Programmer's Guide for
19
proper usage of the API (http://www.opensound.com/pguide).
21
Most programs have been written by 4Front Technologies but some of the
22
oldest ones have different origins.
24
Please contact hannu@opensound.com if you have any questions.
26
**********************************************************************
27
All these programs are released under GNU Public License (GPL) version
28
2.0 or CDDL (if you prefer it). However there are few files that have
29
a different license. In that case the copying conditions will be
30
mentioned in the beginning of the files.
31
**********************************************************************
33
Brief description of the directories
34
------------------------------------
36
To compile most of the programs just go to the directory ane execute "make"
37
or "make install". Some of the programs need to be compiled by hand. Use
38
"make install" in the main directory to compile and install all of them.
40
dsp Very very old utilities. Many of them are still functional.
42
ossmixer.c The "reference implementation" of an OSS mixer program. This
43
program uses the traditional OSS mixer API which is very limited.
44
Superseded by the ossmix/ and ossxmix/ programs.
46
ossmplay A MIDI player that uses the /dev/music API.
48
The ossmix and ossxmix programs use the OSS mixer extension API that is to
49
be officially released in OSS 4.0. Some minor changes are still planned to
50
this API so please keep this in mind if using these sources.
52
ossmix A command line OSS mixer.
53
ossxmix A GTK+ based mixer/control panel program.
54
ossrec A simple command line .wav file recording applet.
55
ossplay A command line audio file player (for most file formats)
56
samples Few OSS programming sample programs.
57
awesfx SB AWE SoundFont Loader for EMU8000 synth.
58
sblive DSP compiler/loader and .DSP file sources for the SB Live/Audigy
59
driver of OSS. May be very impossible to understand without
60
documentation. Sorry for the time being.
61
tests Various test programs used to test this and that during
62
development of OSS. Can be used as programming examples.