diff --git a/docs/define_loudspeakers.maxref.xml b/docs/define_loudspeakers.maxref.xml new file mode 100755 index 0000000..06d8c99 --- /dev/null +++ b/docs/define_loudspeakers.maxref.xml @@ -0,0 +1,135 @@ + + + + + + + Configure speakers for vector-based amplitude panning + + + Use define_loudspeakers to compute a distribution matrix for multiple vbap objects. + + + + + + + Ville Pulkki + + + Nathan Wolek + + + MSP + + + Spatialization + + + spat + + + Multichannel + + + + + + + + + A bang will calculate a new loudspeaker-matrices given the current loudspeaker position settings. + + + + + + + + + + + The loudspeaker-matrices message is specially formatted for the vbap object. + + + + + + + + + + + Number of dimensions (2 or 3) + + + Number of dimensions in your speaker configuration (2 or 3) + + + + + List of azimuth and elevation sets. + + + List of azimuth and elevation sets to define your speaker configurations. 2D setups only requires azimuth, while 3D setups requires azimuth and elevation pairs. The number of sets should equal the number of speakers in your setup. + + + + + + + + + + + Calculate new loudspeaker-matrices + + + A bang at define_loudspeakers's input will calculate a new configuration for the current loudspeaker position settings, then output the results as a loudspeaker-matrices message for the vbap object. + + + + + + + ls-directions followed by the number of dimensions (2 or 3) and list of azimuth and elevation sets for each speaker will define a new configuration without causing output. + + + ls-directions followed by the number of dimensions (2 or 3) and list of azimuth and elevation sets for each speaker will define a new configuration without causing output. 2D setups only requires azimuth, while 3D setups requires azimuth and elevation pairs. The number of sets should equal the number of speakers in your setup. + + + + + + Sets user-defined triads of speakers used by vbap for 3D gain factors calculation. + + + + + + + + Enable posting a notification in Max console when vbap is properly set up + + + + + + + + + + + + + + + + + + +When receiving a bang at its input, define_loudspeakers outputs a loudspeaker-matrices message for the vbap object + + + +