SpatDIF

1

h1. jmod.sur.vimic~

2

1

3

1

h1. Summary

4

1

5

1

* Description: Virtual Microphone Control in a Jamoma Module

6

1

* Developer: Nils Peters, Tristan Matthews, Jonas Braasch, Stephen McAdams

7

1

* Version: 2.2.2009

8

1

* Platform: MaxMSP - Jamoma

9

1

* OS: MacOS

10

1

* License:

11

1

* Status of this entry: in progress

12

1

13

1

h1. Parameter definition

14

1

15

1

h2. Coordinate system convention

16

1

17

1

* Cartesian coordinates: Mathematical system (x-axis to the right, y-axis to the front, z-axis to the top)

18

1

** Center of origin (0,0,0): in the middle of the virtual room

19

1

* Spherical coordinates: Navigational system

20

1

21

1

h2. Parameter describing a sound source

22

1

23

1

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

24

1

| /source.#/position | position of the #th source in cartesian coordinates | float float float |   | 0. 0. 0.  | meter | /source.1/position -1. 1. 0. |    |

25

1

| /source.#/position/aed | position of the #th source in spherical coordinates | float float float |   |   | degree degree meter | /source.1/position/aed 45. 0. 5.  |    |

26

1

| /source.#/orientation/yaw | yaw angle of the #th source | int | -180...180 | 0. | degree | /source.3/orientation/yaw 45 | range is wraped  |

27

1

| /source.#/orientation/active | activates 3th source orientation | boolean | 1 0 | 0 | NA | /source.3/orientation/active 1 |    |

28

1

| /source.#/gain | gain of the #th source | float | 0..127 | 0. | Jamoma-MIDI | /source.4/gain 100 |    |

29

1

| /source.#/active | activates 3th source rendering | boolean | 1 0 | 0 | NA | /source.2/active 1 |    |

30

1

31

1

h2. Parameter describing a virtual space

32

1

33

1

* in the following the placeholder ## stands for the different walls "left", "right", "front", "rear", "floor", "ceiling".

34

1

35

1

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

36

1

| /room/size/xyz | Size of the virtual room in width, length and height | float float float | 0. 40.  | 20. 30. 8. | meter | /room/size/xyz 14. 23. 4. |    |

37

1

| /room/temperature | temperature to calculate speed-of-sound | float | -20. ... 30. | 21 | degree Celsius | /room/temperature 25. |    |

38

1

| /room/reflection/order  | maximum order of rendered early reflections  | int | 0 1 2  | 0 | NA | /room/reflection/order 1 | 0 means only direct sound components  |

39

1

| /room/reflection/gain.#  | gain of the #th reflection order | float | 0 ... 127 | 0. | Jamoma-MIDI | /room/reflection/gain.0 100 | only valid if /room/reflection/order is set accordingly  |

40

1

| /room/reflection/airfilter |  damping frequency of the early reflections due to air absorption | int | 500 .. 19000 | 6000 | Hz | /room/reflection/airfilter 4000 | filter will be applied to early reflections   |

41

1

| /room/absorption.##/low | absorption for the low frequencies of the ## wall  | float | 0.1 .. 99.9 | 99.9 | % absorption |   |    |

42

1

| /room/absorption.##/mid | absorption for the mid frequencies of the ## wall  | float | 0.1 .. 99.9 | 99.9 | % absorption |   |    |

43

1

| /room/absorption.##/high | absorption for the high frequencies of the ## wall | float | 0.1 .. 99.9 | 99.9 | % absorption |   |    |

44

1

| /room/absorption.##/low_mid_frequency | low-mid crossover frequency for the ## wall filter  | int | 10 9999 | 250 | Hz |   |    |

45

1

| /room/absorption.##/mid_high_frequency | mid-high crossover frequency for the ## wall filter  | int | 10 9999 | 5000 | Hz |   |    |

46

1

| /room/absorption.##/preset | absorption presets for the ## wall  | symbol |   |   |   | /room/absorption.left/preset brick |    |

47

1

| /room/distance/mode | distance attenuation function | symbol | "inverse", "exponential" | inverse | NA | /room/distance/mode inverse | inverse square law or exponential decay  |

48

1

| /room/distance/dbunit | db-Unit for exponential attenuation function due to distance  | float | 0. .. 60.0 | 3. | dB | /room/distance/dbunit 1.5 | applicable according to settings of of distance mode   |

49

1

| /room/distance/power | exponent x of the distance function 1/d^x  | float | 0.0 .. 9.0 | 1. | NA | /room/distance/power 0.75 | applicable according to settings of distance mode   |

50

1

51

1

h2. Parameter describing the position of loudspeakers

52

1

53

1

* in ViMiC, instead of loudspeakers the position of virtual microphones is defined

54

1

55

1

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

56

1

| microphones/amount |   |   |   |   |   |   |    |

57

1

| /microphones.#/position |   | float float float |   |   | meter  |   |    |

58

1

| /microphones.#/position/aed |   | flaot float float |   |   | degree degree meter |   |    |

59

1

| /microphones.#/orientation/pitch |   | float | -180. .. 180 |   | degree |   | range is wraped  |

60

1

| /microphones.#/orientation/yaw |   | float | -180. .. 180 |   | degree |   | range is wraped  |

61

1

| /microphones.#/orientation |   | float float | -180. .. 180 |   | degree |   | range is wraped  |

62

1

| /microphones.#/directivity/preset |   | symbol | 'omni' ... "figure-8" |   | NA |   |    |

63

1

| microphones/directivity/power  |   | int | 0 .. 9 |   | NA |   |    |

64

1

| microphones/polarity  |   | boolean | 1 0 |   | NA |   |    |

65

1

| /microphones.#/directivity/ratio |   | float | 0 ... 1. |   | NA |   |    |

66

1

| /microphones.#/gain |   | float | 0 .. 127. |   | Jamoma-MIDI |   |    |

67

1

| /microphones.#/active |   | boolean | 1 0 |   | NA |   |    |

68

1

| /microphones.#/solo |   | boolean | 1 0 |   | NA |   |    |

69

1

71

1

72

1

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

73

1

| miscParameter1 |   |   |   |   |   |   |    |

74

1

| miscParameter2 |   |   |   |   |   |   |    |

75

1

76

1

h1. Projects, sound, and music

77

1

78

1

* Sean Ferguson “Ex Asperis”, Chamber orchestra & live electronics, Canada, 2008

79

1

* Sound Installation at the Eurêka! Science Festival, Canada, 2008

80

1

* IMAX movie: “Molecules to the Max”, US, premiere early 2009

81

82

83

84

h1. References

85

1

86

1

* Peters, N., Matthews, T., Braasch, J., and McAdams, S. (2008). Spatial Sound Rendering in Max/MSP with ViMiC. In Proc. of the International Computer Music Conference ICMC08, Belfast, UK. "[pdf]":http://www.music.mcgill.ca/%7Enils/papers/ICMC08-VIMIC_final.pdf

88

1

h1. External Links

89

1

90

1

* http://www.music.mcgill.ca/musictech/

91

1

* http://www.cirmmt.mcgill.ca/

92

1

93

1

h1. Media

Jmodsurvimic~