Go to file
fundamental 178a970a6a WIP 2018-09-09 12:39:38 -04:00
src WIP 2018-09-09 12:39:38 -04:00
test Fix 1.0 API difference + 0.7 Warning 2018-09-09 12:30:59 -04:00
.travis.yml Remove 0.6 Support + Add "using Printf" 2018-09-09 12:34:17 -04:00
COPYING README + COPYING 2014-06-22 15:25:44 -04:00
README.md Adding MD title spaces a prettier README.md 2018-08-30 20:48:03 -04:00
REQUIRE WIP 2018-09-09 12:37:29 -04:00
VERSION Add Normal Package Layout 2013-10-16 18:56:10 -04:00

README.md

OSC.jl -- Implementation of the Open Sound Control Serialization Format

Build Status

OSC.jl provides an implementation of the OSC binary format commonly used in networked control of musical applications. The code is based on a relatively straightforward translation of librtosc(https://github.com/fundamental/rtosc)

Sample Usage

i = Int32(          42         ); #integer
f = Float32(        0.25;      ); #float
s =                "string"       #string
b =                 s;            #blob
h = Int64(          -125;      ); #long integer
t = UInt64(         22412;     ); #timetag
d = Float64(        0.125;     ); #double
S =                 "Symbol"      #symbol
c = Char(           'J'        ); #character
r = Int32(          0x12345678 ); #RGBA
m = Array{UInt8,1}( [0x12,0x23,   #midi
                     0x34,0x45]);
#true
#false
#nil
#inf

msg = OscMsg("/dest", "[ifsbhtdScrmTFNI]", i,f,s,b,h,t,d,S,c,r,m);
show(msg)

This produces:

OSC Message to /dest
    Arguments:
    # 1 i:Int32 - 42
    # 2 f:Float32 - 0.25
    # 3 s:String - string
    # 4 b:Blob - Uint8[115 116 114 105 110 103]
    # 5 h:Int32 - -125
    # 6 t:Uint64 - 22412
    # 7 d:Float64 - 0.125
    # 8 S:Symbol - Symbol
    # 9 c:Char - J
    #10 r:RBG - 305419896
    #11 m:Midi - Uint8[18 35 52 69]
    #12 T: - true
    #13 F: - false
    #14 N:Nothing - nothing
    #15 I:Inf - nothing

Accessing the fields is done via the [] operator.

Networked Usage

Most of the usage is going to involve sending the OSC messages over UDP to another program. To do this, first start two julia instances. In the first one run

using OSC
sock2 = UDPSocket()
bind(sock2, ip"127.0.0.1", 7777)
msg2 = OscMsg(recv(sock2))

The first instance will now wait for the second to send an OSC message. To send the an OSC message, in the second window type.

using OSC
sock1 = UDPSocket()
msg1 = OSC.message("/hello world", "sSif", "strings", "symbols", 234,
float32(2.3))
send(sock1, ip"127.0.0.1", 7777, msg1.data)

TODO

  • Port bundle message support from librtosc

LICENSE

OSC.jl is licensed under the LGPLv3 License