OSC Documentation

©Patrick‐GillesMaillot 17 WINGOSC–V0.58
W>,60B:/$ctl/user/1/1/enc~~,sssss~~mode~~~~name~~~~$fname~~fx~~par~
NodeData
WINGnodescanalsobeusedtosetmultiplevalueswithusingasingleOSC“/”command,andoffera
simpleyeteffectivewaytonavigatewithinthehierarchicalstructureofJSONdata.Sayyouwant/need
tosetfaderandmutevaluesto‐1dB,0dB,OFFandONforchannels1and2;Thiscanbeachievedin
asingleOSCrequestusingthefollowingsyntax:
>W,44B:/~~~,s~~/ch.1.fdr=1,mute=0,.2.fdr=0,mute=1~
Orsettingchannel1faderandmutevaluesto10dBandON,andsettingbus1faderto5dB:
>W,44B:/~~~,s~~/ch.1.fdr=10,mute=1,/bus.1.fdr=5~~~~
Asshownabove,eachparametergroupisseparatedbya‘
,’character,the‘/’characterrepresents
therootoftheJSONparametertree,and‘
.’charactersareusedtonavigateupanddownwithinthe
JSONparametertree.
Theconsolewillreplywith
/*~~,s~~OK~~ifthecommandwasaccepted,oroneofthefollowing:
/*~~,s~~NODENOTFOUND~~
/*~~,s~~VALUEERROR~~~~~
/*~~,s~~BUFFEROVERFLOW~
/*~~,s~~NODEISNOTPAR~
/*~~,s~~INCOMPLETEDATA~
/*~~,s~~STACKEMPTY~~~~~
ifanerroroccurredduringtheexecutionofthecommand.
Note:Nodescanreturnlargeamountsofdata;asaresult,somenodescannotbereturnedusing
OSC/UDPastheywouldoverflowthe32kBUDPbufferlimitation;Insuchsituation,WINGwillreturnan
errorOSCmessageevent.
Somenodesexamplesareprovidedbelow:
>W,12B:/ch/1/fdr~~~
W>,32B:/ch/1/fdr~~~,sff~~~~oo~[0.0000][144.0000]
>W,12B:/ch/1/mute~~
W>,32B:/ch/1/mute~~,sfi~~~~1~~~[1.0000][1]
>W,12B:/ch/2/fdr~~~
W>,32B:/ch/2/fdr~~~,sff~~~~oo~[0.0000][144.0000]
>W,12B:/ch/2/mute~~
W>,32B:/ch/2/mute~~,sfi~~~~0~~~[0.0000][0]
>W,44B:/~~~,s~~/ch.1.fdr=1,mute=0,.2.fdr=0,mute=1~
W>,12B:/*~~,s~~OK~~
>W,12B:/ch/1/fdr~~~
W>,36B:/ch/1/fdr~~~,sff~~~~1.0~~~~[0.7250][1.0000]
>W,12B:/ch/1/mute~~
W>,32B:/ch/1/mute~~,sfi~~~~0~~~[0.0000][0]
>W,12B:/ch/2/fdr~~~
W>,32B:/ch/2/fdr~~~,sff~~~~0.0~[0.7500][0.0000]
>W,12B:/ch/2/mute~~
W>,32B:/ch/2/mute~~,sfi~~~~1~~~[1.0000][1]
NodescanalsobelocateddeeperintheJSONstructuretree.Forexample,changingasingle
parameterinthenodechannel1[”
/ch/1”]canbedoneasshownbelow:
>W,20B:/ch/1~~~,s~~fdr=3~~~
W>,16B:/ch/1*~~,s~~OK~~
>W,12B:/ch/1/fdr~~~
W>,32B:/ch/1/fdr~~~,sff~~~~3.0~[0.8250][3.0000]