zzkt/osc
1
0
Fork 0
Code Issues 7 Pull requests Projects Releases Activity Actions
a common lisp implementation of the Open Sound Control protocol aka OSC
49 commits 3 branches 0 tags 464 KiB
Common Lisp 100%
Find a file
Jamie Forth 79d25ca4e0 export some more user-convenience functions
2015-10-14 14:21:30 +01:00
devices add convenience functions for constructing message and bundle objects 2015-08-21 18:29:12 +01:00
LGPL.txt seed 2005-01-26 21:52:24 +08:00
LICENCE.txt recognosce 2005-11-29 19:11:26 +08:00
osc-data.lisp add convenience functions for constructing message and bundle objects 2015-08-21 18:29:12 +01:00
osc-dispatch.lisp implement sending and receiving of nested bundles 2015-08-21 15:24:04 +01:00
osc-examples.lisp code reformat 2015-07-10 16:41:42 +01:00
osc-time.lisp code reformat 2015-07-10 16:41:42 +01:00
osc.asd implement sending and receiving of nested bundles 2015-08-21 15:24:04 +01:00
osc.lisp add convenience functions for constructing message and bundle objects 2015-08-21 18:29:12 +01:00
package.lisp export some more user-convenience functions 2015-10-14 14:21:30 +01:00
README.md update README 2015-08-21 15:36:49 +01:00

README.md

Open Sound Control

This is a common lisp implementation of the Open Sound Control Protocol aka OSC. The code should be close to the ansi standard, and does not rely on any external code/ffi/etc+ to do the basic encoding and decoding of packets. since OSC does not specify a transport layer, messages can be send using TCP or UDP (or carrier pigeons), however it seems UDP is more common amongst the programmes that communicate using the OSC protocol. the osc-examples.lisp file contains a few simple examples of how to send and recieve OSC via UDP, and so far seems reasonably compatible with the packets send from/to max-msp, pd, supercollider and liblo. more details about OSC can be found at http://www.cnmat.berkeley.edu/OpenSoundControl/

The devices/examples/osc-device-examples.lisp contains examples of a higher-level API for sending and receiving OSC messages.

the current version of this code is avilable from github

git clone https://github.com/jamieforth/osc

(fork from https://github.com/zzkt/osc)

limitations

  • will raise an exception if the input is malformed
  • doesn't do any pattern matching on addresses
  • float en/decoding only tested on sbcl, cmucl, openmcl and allegro
  • only supports the type(tag)s specified in the OSC spec

things to do in :osc

  • address patterns using pcre
  • data checking and error handling
  • portable en/decoding of floats -=> ieee754 tests
  • doubles and other defacto typetags

things to do in :osc-ex[tensions|tras]

  • liblo like network wrapping
  • add namespace exploration using cl-zeroconf

changes

  • 2015-08-21
    • implement nested bundles
  • 2011-04-19
    • converted repo from darcs->git
  • 2010-09-25
    • add osc-devices API
  • 2010-09-10
    • implement timetags
  • 2007-02-20
  • 2006-02-11
    • version 0.4
    • partial timetag implementation
  • 2005-12-05
    • version 0.3
    • fixed openmcl float bug (decode-uint32)
  • 2005-11-29
    • version 0.2
    • openmcl float en/decoding
  • 2005-08-12
  • 2005-08-11
    • version 0.1
  • 2005-03-16
    • packaged as an asdf installable lump
  • 2005-03-11
    • bundle and blob en/de- coding
  • 2005-03-05
    • 'declare' scattering and other optimisations
  • 2005-02-08
    • in-package'd
    • basic dispatcher
  • 2005-03-01
    • fixed address string bug
  • 2005-01-26
    • fixed string handling bug
  • 2005-01-24
    • sends and receives multiple arguments
    • tests in osc-tests.lisp
  • 2004-12-18
    • initial version, single args only