OSC.jl/README.md

94 lines
2.3 KiB
Markdown
Raw Normal View History

2014-06-22 21:25:44 +02:00
OSC.jl -- Implementation of the Open Sound Control Serialization Format
-----------------------------------------------------------------------
2013-10-17 00:56:10 +02:00
2014-06-22 21:25:44 +02:00
[![Build Status](https://travis-ci.org/fundamental/OSC.jl.png)](https://travis-ci.org/fundamental/OSC.jl)
_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
```julia
i::Int32 = 42; #integer
f::Float32 = 0.25; #float
s::ASCIIString = "string"; #string
b = s; #blob
h::Int64 = -125; #long integer
t::Uint64 = 22412; #timetag
d::Float64 = 0.125; #double
S::ASCIIString = "Symbol"; #symbol
c::Char = 'J'; #character
r::Int32 = 0x12345678; #RGBA
m::Array{Uint8,1} = [0x12,0x23, #midi
2014-06-22 23:29:15 +02:00
0x34,0x45];
2014-06-22 21:25:44 +02:00
#true
#false
#nil
#inf
msg = OscMsg("/dest", "[ifsbhtdScrmTFNI]", i,f,s,b,h,t,d,S,c,r,m);
show(msg)
```
2013-10-17 00:56:10 +02:00
2014-06-22 23:29:15 +02:00
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.
2014-06-22 21:25:44 +02:00
##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
```julia
using OSC
sock2 = UdpSocket()
2014-06-25 17:27:53 +02:00
bind(sock2, ip"127.0.0.1", 7777)
2014-06-22 21:25:44 +02:00
msg2 = OscMsg(recv(sock2))
```
2014-06-18 23:18:11 +02:00
2014-06-25 17:27:53 +02:00
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.
2014-06-18 23:18:11 +02:00
2014-06-22 21:25:44 +02:00
```julia
2014-06-18 23:18:11 +02:00
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)
2014-06-22 21:25:44 +02:00
```
2014-06-18 23:18:11 +02:00
2014-06-22 21:25:44 +02:00
##TODO
- Port bundle message support from librtosc
##LICENSE
OSC.jl is licensed under the LGPLv3 License