SpatDIF

h1. IRCAM Spatialisateur

{{toc}}

h1. Summary

    * *Description:* The Spatialisateur project started in 1991 as a collaboration between Espaces Nouveaux and Ircam. Its goal is to propose a virtual acoustics processor which allows composers, performers or sound engineers to control the diffusion of sounds in a real or virtual space. This project stems from research carried out within the Ircam room acoustics laboratory on the objective and perceptive characterization of room acoustic quality. It also incorporates research done at Télécom Paris on digital signal processing algorithms for the spatialization and artificial reverberation of sounds. Spat~ is an effort to organize and optimize the experimental patches developped in the Spatialisateur project, in order to make them accessible to musicians and researchers who work with Max/MSP. The current release allows reproduction on multi-channel loudspeaker systems in studios or concert halls. It also integrates 3D stereo reproduction modes for headphones (binaural) or 2 loudspeakers (transaural), as well as Vector Based Amplitude Panning and Ambisonics.

    * *Manufacturer / Developer:* Ircam / Espaces Nouveaux

    * *Version:* 4.1.5

    * *Platform:* Spat 4 runs on Max/MSP version 5.0.0 or higher.

    * *OS:* Spat 4 is compatible with both Mac OS X (Universal Binary) and Windows XP/Vista.

    * *License:* The use of Spatialisateur and its documentation is restricted to members of the "Ircam software users group":http://forumnet.ircam.fr/?L=1.

    * *Trademark:* Spatialisateur is an IRCAM registered trademarks.

    * *Patents:* The design of Spat and the reverberation module are protected under different French and international patents ([FR] 92 02528; [US] 5,491,754, [FR] 95 10111; [US] 5,812,674).	

    * *Status of this entry:* In progress

h1. Parameter definition

h2. Coordinate system convention

    * what is the underlying coordinate system?

    * any relation to the [[proposed coordinate systems]] ?

Spat 4 implements several coordinate systems, all defined from the listener’s point of view (i.e. the listener is the origin of the coordinate system). In Max/MSP these different coordinate systems are : 

    * xyz : 3D Cartesian coordinates

    * xy : 2D Cartesian coordinate within xy plane

    * ade : azimuth, distance, elevation

    * aed : azimuth, elevation, distance

    * ad : azimuth, distance (2D within xy plane)

    * az : azimuth only (distance = 1 m)

    * spat3 : azimuth, distance, elevation format for backward compatibility with Spat 3.x convention

Spat 4 external objects can interpret messages formatted in any of these coordinate formats. Furthermore utilities objects are provided to perform conversions between the different coordinate systems.

h3. Cartesian coordinates (xyz)

X axis on the right of the listener Y axis in front Z axis to the top

p=. !http://redmine.spatdif.org/attachments/89/spat.xyz.1.png!

p=. _Top view (xy plane)_

p=. !http://redmine.spatdif.org/attachments/90/spat.xyz.2.png!

p=. _Front view (xz plane)_

h3. Navigational coordinates (ade)

The default coordinate system in Spat 4 is called the navigational coordinate system. Positions are expressed in term of azimuth, elevation and distance (format “ade” in Max/MSP). Azimuth is measured toward the y axis, with 0° in front of the listener.

Elevation is 0° within xy plane. +90° on top, -90° bottom.

h3. Spat 3.x coordinate system (spat3)

h2. Parameter describing a sound source

|_. *parameter*     |_. *description*|_. *data format*|_. *range*|_. *initial state*|_. *unit*|_. *example*|_. *misc*|

|sourceParameter1|...          |...|...|...                          |unit|...|...| 

|sourceParameter2|...          |...|...|...                          |unit|...|...|

|sourceParameter3|...          |...|...|...                          |unit|...|...|

|sourceParameter4|...          |...|...|...                          |unit|...|...| 

|sourceParameter5|...          |...|...|...                          |unit|...|...|

|sourceParameter6|...          |...|...|...                          |unit|...|...|

h2. Parameter describing a virtual space

|_. *parameter*     |_. *description*|_. *data format*|_. *range*|_. *initial state*|_. *unit*|_. *example*|_. *misc*|

|spaceParameter1|...          |...|...|...                          |unit|...|...| 

|spaceParameter2|...          |...|...|...                          |unit|...|...|

|spaceParameter3|...          |...|...|...                          |unit|...|...|

|spaceParameter4|...          |...|...|...                          |unit|...|...| 

|spaceParameter5|...          |...|...|...                          |unit|...|...|

|spaceParameter6|...          |...|...|...                          |unit|...|...|

h2. Parameter describing the position of loudspeakers

|_. *parameter* |_. *description*|_. *data format*|_. *range*|_. *initial state*|_. *unit*|_. *example*|_. *misc*|

|speakerParameter1|...          |...|...|...                          |unit|...|...| 

|speakerParameter2|...          |...|...|...                          |unit|...|...|

|speakerParameter3|...          |...|...|...                          |unit|...|...|

|speakerParameter4|...          |...|...|...                          |unit|...|...| 

|speakerParameter5|...          |...|...|...                          |unit|...|...|

|speakerParameter6|...          |...|...|...                          |unit|...|...|

h2. Other parameter

|_. *parameter* |_. *description*|_. *data format*|_. *range*|_. *initial state*|_. *unit*|_. *example*|_. *misc*|

|miscParameter1|...          |...|...|...                          |unit|...|...| 

|miscParameter2|...          |...|...|...                          |unit|...|...|

|miscParameter3|...          |...|...|...                          |unit|...|...|

|miscParameter4|...          |...|...|...                          |unit|...|...| 

|miscParameter5|...          |...|...|...                          |unit|...|...|

|miscParameter6|...          |...|...|...                          |unit|...|...|

h1. Projects, sound, and music

    * art or research projects utilizing this spatial renderer

h1. References

    * Bibliography

h1. External Links

    * http://forumnet.ircam.fr/692.html?&L=1

    * www.spatdif.org

h1. Media

    * GUI screenshots

    * Example patches

    * things which might explain the listed content better

    * you can add files to a wiki page by clicking on "new file" at the bottom