v0.4
polar position messages
| osc address |
type |
units |
min |
max |
default |
>description |
example |
status |
| /adm/obj/n |
/azim |
float |
degrees |
-180.0 |
180.0 |
- |
azimuth “theta - θ” of sound location. -90 is on the Right, 0 is in front. |
/adm/obj/4/azim -22.5 |
stable v0.4 |
| /elev |
float |
degrees |
-90.0 |
90.0 |
- |
elevation “phi - ɸ” of sound location |
/adm/obj/4/elev 12.7 |
stable v0.4 |
| /dist |
float |
normalized |
0.0 |
1.0 |
1.0 |
distance “r” from origin |
/adm/obj/4/dist 0.9 |
stable v0.4 |
| /aed |
list |
see above |
compact format enables synchronicity of position changes and also less network traffic |
/adm/obj/4/aed -22.5 12.7 0.9 |
stable v0.4 |
| /widthDeg |
float |
degrees |
0.0 |
180.0 |
0.0 |
horizontal extent in degrees. See also /w |
/adm/obj/3/widthDeg 45.2 |
in progress |
| /gain |
float |
linear |
0. |
|
1.0 |
Apply a gain to the audio in the object. |
/adm/obj/3/gain 0.707 |
stable v0.4 |
Cartesian position messages
| osc address |
type |
units |
min |
max |
default |
description |
example |
status |
| /adm/obj/n |
/x |
float |
normalized |
-1.0 |
1.0 |
0.0 |
left/right dimension. -1 is left |
/adm/obj/4/x -0.9 |
stable v0.4 |
| /y |
float |
normalized |
-1.0 |
1.0 |
0.0 |
front/back dimension. 1 is front |
/adm/obj/4/y 0.15 |
stable v0.4 |
| /z |
float |
normalized |
-1.0 |
1.0 |
0.0 |
top/bottom dimension. 1 is top |
/adm/obj/4/z 0.7 |
stable v0.4 |
| /xyz |
list |
see above |
compact format enables synchronicity of position changes and also less network traffic |
/adm/obj/4/xyz -0.9 0.15 0.7 |
stable v0.4 |
| /w |
float |
normalized |
0.0 |
1.0 |
0.0 |
horizontal extent in normalized units |
/adm/obj/3/w 0.2 |
in
progress |
| /gain |
float |
linear |
0. |
|
1.0 |
Apply a gain to the audio in the object. |
/adm/obj/3/gain 0.707 |
stable v0.4 |
configuration messages
| osc address |
type |
units |
min |
max |
default |
description |
example |
status |
| /adm/obj/n/config |
/cartesian |
int |
0/1 |
0 |
1 |
0 |
If the flag is set to 1, Cartesian coordinates are used. Otherwise spherical coordinates are
used. |
/adm/config/obj/1/cartesian 0 |
stable v0.4 |
| /dMax |
float |
meters |
0. |
|
|
Distance signified by a normalized dRef value of 1 |
/adm/config/obj/1/dMax 21.3 |
in
progress |
| /dRef |
float |
normalized |
0.0 |
1.0 |
1.0 |
Distance where dimensionless rendering is replaced with with physics-based rendering. |
/adm/config/obj/1/dRef 0.2 |
in
progress |
