OSC Documentation

©Patrick‐GillesMaillot 13 WINGOSC–V0.58

OSCRemoteProtocol
WINGincludesanOSCRemoteProtocolserver.Thisenableseasyaccesstoremotefeaturesformany
professional,soundapplicationsandextensionsofferedbythirdparties.
OSCremotecontrolenablesreadingandmodifying(whenpossible)allparametersincludedinthe
ae_dataandce_dataJSONstructures,allpartofthemainparametertree.

WINGOSCserverimplementationcomplieswiththeOSCstandard
4
andproposesseveralwaysto
accessdata,parameters,andfeatures.AsallOSCcompliantservers,theWINGOSCserverrunsinthe
consoleandwillreplytoUDPonaspecificport:
2223.
WhenusingstandardUDPcommunication,clientswillberepliedontotheircallingport.Ifneeded,a
specificfeatureenablesWINGtoreplytoaUDPportspecifiedbytheconnectedclient,asexplained
laterinthisdocument.
OSCDataTypes
IncompliancewiththeOSCstandard,WINGsupportsthefollowingtypes:

int32(32bits,bi‐endian),

float32(32bits,IEEE754,bigendian),

string(non‐nullASCIIcharactersfollowedbyanull,followedby0‐3additionalnullcharacters
tomakethetotalnumberofbytesamultipleof4),

blob(Anint32sizecount,followedbythatmany8‐bitbytesofarbitrarybinarydata,followed
by0‐3additionalzerobytestomakethetotalnumberofbytesamultipleof4).

Asspecifiedinthe
OSCstandard,theunitoftransmissionofOSCisanOSCPacket.Anyapplicationthat
sends
OSCPacketsisanOSCClient;WINGembedsandrunsanOSCServer.

An
OSCPacketconsistsofitscontents,acontiguousblockofbinarydata,anditssize,thenumberof
8‐bitbytesthatcomprisethecontents.Thesizeofan
OSCpacketisalwaysamultipleof4.
InthecaseofWING,thecontentofan
OSCpacketisalwaysanOSCMessage,i.e.,OSCBundlesarenot
supported.Notethatwildcards‘
?’and‘*’inAddressPatternsarereservedforspecialcases.
An
OSCMessageconsistsofanOSCAddressPatternfollowedbyanOSCTypeTagStringfollowedby
zeroormore
OSCArguments.SomeolderimplementationsofOSCmayomittheOSCTypeTagstring
andWINGsupportsthis.

OSCAddressPatternsalwaysstartwiththecharacter‘/’.

OSCTypeTagscanbei,f,s,bforint32,float32,stringandblob,respectively

OSCArgumentsconsistinasingleoracontiguoussequenceofthebinaryrepresentationsof
eachargument
ThemaximumUDPpacketsizeis32kbytes.



4
Seehttp://opensoundcontrol.org/spec‐1_0