ADM-OSC

Logo

An OSC dictionary that implements the Audio Definition Model (ADM)

View the Project on GitHub immersive-audio-live/ADM-OSC

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 /adm/obj/4/y 0.15 stable v0.4
/z float normalized -1.0 1.0 0.0 top/bottom dimension /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