README
1Sound Space
2===========
3
4This is a toy program for playing with positional audio in pyglet
5(http://www.pyglet.org). On Linux, OpenAL is required.
6
7The source code is licensed under the BSD license, which is quite permissive
8(see the source headers for details).
9
10Audio samples were generated with Apple GarageBand.
11
12Usage
13-----
14
15Run the toy with::
16
17 python soundspace.py
18
19Everything is controlled with the mouse. Hover over a control to
20see its name. Click and drag an empty area to pan the view, and scroll the
21scroll wheel to zoom in and out.
22
23The red triangles can be dragged to move the position of a player or listener.
24
25The dashed line to the yellow handle shows the cone orientation; this can be
26reoriented by dragging it.
27
28The blue and green segments represent the outer and inner cone angles,
29respectively. You can resize the angle by dragging the handle attached to the
30cone.
31
32There is a master volume control beneath the listener.
33
34Click the (+) sign on a player to show the min_gain, max_gain, cone_outer_gain
35and volume controls.
36
37The initial configuration is given in res/space.txt; it should be
38self-explanatory (parsed by reader.py).
39