CICM tools

Version 11 (Nils Peters, 03/30/2009 01:35 am)

1 1
h1. CICM tools
2 1
3 1
4 1
h1. Summary
5 1
6 1
* Description: 1st order Ambisonics rendering for horizontal-only (ambipan~) or spherical loudspeaker setups (ambicube~)
7 6 Nils Peters
* Manufacturer / Developer: Remi Mignot , Benoit Courribet / CICM Universite Paris Nord
8 1
* Version:
9 1
* Platform: Pure Data, MaxMSP
10 1
* OS: (Linux, MacOS, Vista)
11 1
* License: GNU LGPL
12 1
* Status of this entry: in progress
13 1
14 1
h1. Parameter definition
15 1
16 1
h2. Coordinate system convention
17 1
18 1
* what is the underlying coordinate system? -- not described in helpfiles, so this is what I guess:
19 1
* cartesian system: mathematical style
20 1
* spherical system: mathematical style ( zero to the right handside)
21 1
* polar coordinates, order of coordinates: distance, radius, (height)
22 1
23 1
24 1
h2. Parameter describing a sound source
25 1
26 1
* ambipan~ or ambicube render one sound source per external, see screenshot below
27 1
28 1
h3. ambipan~
29 1
30 10 Nils Peters
{background:#ddd}. |*parameter*     |*description*|*data format*|*range*|*initial state*|*unit*|*example*|*misc*|
31 6 Nils Peters
|2nd leftmost inlet|x-coordinate| signal or float| ?|?|depends on setting|  |  |
32 7 Nils Peters
|3rd leftmost inlet|y-coordinate| signal or float| ?|?|depends on setting|  |  |
33 6 Nils Peters
|list| coordinate triplet at control rate|float float float|?|?|depends on setting| | |
34 6 Nils Peters
|2nd initial argument|coordinate system|char|"c" cartesian, "p" cylindrical|cartesian| |ambicube~ p|can also be changed with message "change_type c" etc.|
35 8 Nils Peters
|3rd initial argument|control type of inputs| char|"c" control rate "s" signal rate|control data| |ambicube~ p s| |
36 6 Nils Peters
|5th initial argument|interpolation time for rendering of position messages|?|?|10|ms| | |
37 6 Nils Peters
|mute_sigmuting the sound source|boolean| 1, 0| | |mute_sig 1| |
38 1
39 1
h3. ambicube~
40 1
41 1
|*parameter*     |*description*|*data format*|*range*|*initial state*|*unit*|*example*|*misc*|
42 3 Nils Peters
|2nd leftmost inlet| x-coordinate| signal or float| ?|?| depends on setting| | |
43 3 Nils Peters
|3rd leftmost inlet| y-coordinate|signal or float|?|?|depends on setting| | | 
44 3 Nils Peters
|4th leftmost inlet| z-coordinate|signal or float|?|?|depends on setting| | |
45 3 Nils Peters
|list| coordinate triplet at control rate|float float float|?|?|depends on setting| | |
46 5 Nils Peters
|1st initial argument|coordinate system|char|c" cartesian, "p" cylindrical, "s" spherical|cartesian| |ambicube~ p|can also be changed with message "change_type c" etc.| 
47 5 Nils Peters
|2nd initial argument|control type of inputs| char|"c" control rate "s" signal rate|control data| |ambicube~ p s| |
48 3 Nils Peters
|4th initial argument|interpolation time for rendering of position messages|?|?|10|ms| | |
49 3 Nils Peters
|mute_sig|muting the sound source|boolean|1, 0| | |mute_sig 1| |
50 1
51 1
h2. Parameter describing a virtual space
52 1
53 1
* none
54 1
55 1
h2. Parameter describing the position of loudspeakers
56 1
57 1
* Loudspeaker-positions are fixed in ambicube~
58 1
* therefore the following messages are only valid for ambipan~
59 2 Nils Peters
60 2 Nils Peters
|*parameter*     |*description*|*data format*|*range*|*initial state*|*unit*|*example*|*misc*|
61 2 Nils Peters
|set_nb_hp|number of loudspeakers|int| |4| |set_nb_hp 5|also 1st initial argument|
62 2 Nils Peters
|xy_setpos|description in cartesian| int int int ....| | | |xy_setpos -1 1 1 1| |
63 1
|ra_setpos|modification with distance and angle|float float ....| | | |ra_setpos 1 135 1 45 0.7 -45 0.7 -135|order: distance azimuth|
64 1
|a_setpos|azimuthal angle, distance is fixed|int int int ....| | |degrees|a_setpos 90 0 -90 -180|distance will be set to 1.0|
65 1
66 1
h2. Ambisonics specific parameter
67 1
68 1
|*parameter*     |*description*|*data format*|*range*|*initial state*|*unit*|*example*|*misc*|
69 1
|set_offset      |Ambisonics offset|float|           |0.3            |?     | set_offset 0.5|can also initialized as initial argument|
70 1
71 1
h1. Projects, sound, and music
72 1
73 1
* art or research projects utilizing this spatial renderer
74 1
75 1
h1. References
76 1
77 2 Nils Peters
* Sedes, A., Courribet, B., and Thiebaut, J. (2003). Egosound, an egocentric interactive and real-time approach of sound space. Proceedings of the DAFX-03, London. "[pdf]":http://www.elec.qmul.ac.uk/dafx03/proceedings/pdfs/dafx43.pdf
78 1
79 1
h1. External Links
80 1
81 1
* http://cicm.mshparisnord.org/
82 11 Nils Peters
83 11 Nils Peters
84 11 Nils Peters
h1. Media