OSC Documentation 0.59

©Patrick‐GillesMaillot 16 WINGOSC–V0.59

Writing(Set)ParameterandNodedata
SingleParameters
OSCcanbeusedtosetormodifyWINGdata.Takingthefaderandmuteexamplesabove,wecan
modifytheirrespectivevaluesusingOSCcommands,sendingstring,big‐endianint32orbig‐endian
float32withthecorrespondingOSCTypeTagfollowingtheOSCAddressPatternrespectiveofthe
parametertochange.
WINGdoesnotechodatasentoverUDPbytheclientapplication.Theclientapplicationmay
neverthelessbenotifiedwithanOSCeventincaseofanerror.
Individualparameterscanbestrings,integer,orfloats;WINGOSCserverimplementationenablesto
useseveraldatatypesandwillmanagetheconversiontoensurepropervaluesettinginsidethe
console.Forexample,faderpositionisafloating‐pointinternalvalue.Itcanbesetasastringorafloat
usingthefollowingOSCcommands(inthisexamplesettingchannel2faderpositionto‐2or‐3dB):
‐>W,20B:/ch/2/fdr~~~,s~~‐2~~
‐>W,12B:/ch/2/fdr~~~
W‐>,36B:/ch/2/fdr~~~,sff~~~~‐2.0~~~~[0.7000][‐2.0000]

‐>W,20B:/ch/2/fdr~~~,f~~[‐3.0000]
‐>W,12B:/ch/2/fdr~~~
W‐>,36B:/ch/2/fdr~~~,sff~~~~‐3.0~~~~[0.6750][‐3.0000]


Enumeratedstrings
OneofthedataWINGusesis“enumeratedstrings”,orthechoiceofonestringinalistofelementsto
representaspecificstateorattributevalue.Forexample,
/$ctl/user/1/1/enc/modecanbeanyofthe
followingstrings:
OFF,FDR,PAN,DCA,SSND,FSND,FX,DAWMCU,SDA,orSDB

ThiscanbesetviaastringOSCtag,asshownbelowifonewantstosetthemodeparametertoFX:
/$ctl/user/1/1/enc
‐>W,20B:/$ctl/user/1/1/enc~~
W‐>,52B:/$ctl/user/1/1/enc~~,sss~~~~mode~~~~name~~~~$fname~~
‐>W,24B:/$ctl/user/1/1/enc/mode~
W‐>,32B:/$ctl/user/1/1/enc/mode~,s~~OFF~
/$ctl/user/1/1/enc/mode,sFX
‐>W,32B:/$ctl/user/1/1/enc/mode~,s~~FX~~
/$ctl/user/1/1/enc/mode
‐>W,24B:/$ctl/user/1/1/enc/mode~
W‐>,32B:/$ctl/user/1/1/enc/mode~,s~~FX~~

ButitcanalsobesetasanintOSCtag,usingtheindexofthelistcorrespondingtothetargetedvalue;
intheexampleabove,
FXsitsatindex6inthelistof10strings;ThisenablesustousethefollowingOSC
commandtosettheencodermodeto
FX:

/$ctl/user/1/1/enc
‐>W,20B:/$ctl/user/1/1/enc~~
W‐>,52B:/$ctl/user/1/1/enc~~,sss~~~~mode~~~~name~~~~$fname~~
‐>W,24B:/$ctl/user/1/1/enc/mode~
W‐>,32B:/$ctl/user/1/1/enc/mode~,s~~OFF~
/$ctl/user/1/1/enc/mode,i6
‐>W,32B:/$ctl/user/1/1/enc/mode~,i~~[6]
/$ctl/user/1/1/enc/mode
‐>W,24B:/$ctl/user/1/1/enc/mode~
W‐>,32B:/$ctl/user/1/1/enc/mode~,s~~FX~~

OnecanalsonotetheextendibilitycharacterofWINGnodes;indeed,afterthepreviouscommand,
theuser1/1encoderhasadditionalparameters:
/$ctl/user/1/1/enc
‐>W,20B:/$ctl/user/1/1/enc~~