VBAP for Pure Data or MaxMSP

Summary

  • Description: Vector Base Amplitude Panning for MaxMSP and Pure Data
  • Developer: Ville Pulkki
  • Platform: MaxMSP, Pure Data
  • Version: 1.03 (MaxMSP), 0.99 (Pure Data)
  • License:
  • needs to be connected to a matrix~ object
  • Status of this entry: finished

Parameter definition

Coordinate system convention

Parameter describing a sound source

parameter description data format range initial state unit example misc
2nd leftmost inlet of vbap azimuth int -∞... ∞ 1st argument, otherwise 0 degree 10
3rd leftmost inlet of vbap elevation int -∞... ∞ 2nd argument otherwise 0 degree 0
4th leftmost inlet of vbap spread the sound signal to multiple panning directions int 0 ... 100 0 percent 100
rightmost inlet of vbap gain control float 0 ... 2 1.0 linear 1.0

Parameter describing a virtual space

  • none

Parameter describing the position of loudspeakers

  • Loudspeaker layout must either be defined through additional object "define_loudspeakers", or by the message "define_loudspeakers" send to 1st inlet to vbap.
  • max number of speakers 55

Defining loudspeaker through message "define_loudspeakers":

parameter description data format range initial state unit example misc
define_loudspeaker 2 angular position data for 2D loudspeaker rig i i ... has to be defined before VBAP is used degree define_loudspeakers 2 -45 45 -135 135 azi1 azi2 azi3 ...
define_loudspeaker 3 angular position data for 3D loudspeaker rig i i i .... degree define_loudspeakers 3 -30 0 30 0 -90 0 90 0 0 0 -150 0 150 0 180 45 -45 45 45 45 pairs of circular coordinates:azi1 ele1 azi2 ele2 ...

Defining loudspeaker through additional object "define_loudspeakers":

parameter description data format range initial state unit example misc
ls-triplets to define the triangular selection of loudspeakers not documented not documented not documented not documented ls-triplets 1 2 7 2 7 8 1 3 7 for experts only
ls-directions 2 same than define_loudspeakers 2 i i ... degree ls-directions 2 -40 0 40 80 130 180 -130 -80 azi1 azi2 azi3 ...
ls-directions 3 same than define_loudspeakers 3 i i i ... degree ls-directions 3 -30 0 30 0 -90 0 90 0 0 0 -150 0 150 0 180 45 -45 45 45 45 pairs of circular coordinates:azi1 ele1 azi2 ele2 ...

Projects

  • many

References

  • Pulkki, V. (2000). Generic panning tools for MAX/MSP. Proceedings of International Computer Music Conference, pages 304–307. [pdf]
  • more references at the main VBAP WIKI page

External Links

Media

vbap.jpg - vbap-screencap (68.2 KB) Nils Peters, 03/30/2009 12:52 am

vbap.spatbase.maxpat - max5 example patch, as shown in the screencap (30.3 KB) Nils Peters, 03/30/2009 01:08 am