SwingOSC -- version 0.61SVN (built 01-oct-08) --

statement

SwingOSC is an OpenSoundControl (OSC) server intended for scripting Java(tm), such as to create graphical user interfaces with AWT or Swing classes. It uses the reflection and beans mechanism to dynamically create instances of java classes and control them. A separate set of SuperCollider language classes is included to allow the building of GUIs from within sclang.

SwingOSC is (C)opyright 2005–2008 by Hanns Holger Rutz. All rights reserved. SwingOSC is released under the GNU General Public License and comes with absolutely no warranties. To contact the author, send an email to contact at sciss.de

For project status, API and current version, visit www.sciss.de/swingOSC.

For OSC communication, SwingOSC uses the NetUtil library, which is licensed under the GNU Lesser General Public License (LGPL). The compiled library is included, for sourcecode and details visit www.sciss.de/netutil. SwingOSC also builds on top of ScissLib which is licensed under the GNU General Public License.

security note

SwingOSC uses UDP and TCP network protocols. It allows to create and execute almost any kind of java code on your machine. Therefore, running SwingOSC in a network that can be accessed from outside is a severe security problem, allowing hijacking, information retrieval and massive damage on your machine. You have been warned!

It is strongly advised to launch SwingOSC with the -L option which limits communication to the local computer. Alternatively, make sure your firewall settings are appropriate.

download

The current version can be downloaded here:

The SuperCollider for Windows built maintained by the IEM Graz already comes with a preconfigured SwingOSC installation (however not always the newest):

Developers can download the lastest version from Subversion (SVN):

> cd <baseDir>
> svn co https://swingosc.svn.sourceforge.net/svnroot/swingosc/trunk/ SwingOSC

The subversion download comes in source form and needs to be compiled (see the compilation section below). The regular download already includes a precompiled binary.

requirements / installation

SwingOSC is written in Java(tm) and requires a Java runtime environment (JRE) version 1.4 or better. On Mac OS X you already have this runtime. On other platforms you may need to download and install a recent runtime from java.sun.com. You can verify your current java version by opening a terminal and executing the command java -version.

Linux note: There are other free implementations for the Java standard platform, like Apache Harmony and GNU Classpath. Kaffe.org has a list of related things. I have tested SwingOSC only with Sun's and Apple's VM and I don't know whether it runs with those alternatives. Particularly AWT (the GUI base system) is incomplete, so I don't recommend using for example gij which seems to be the default on Debian / Ubuntu. Installing Sun's Java does not imply that you cannot have your current alternative Java installed (see nescivi's posting on this thread for details: www.nabble.com/swingOSC-installation-on-Linux-Ubuntu-7.04-t4638827.html).

To use MovieView.java (i.e. JSCMovieView), you will need the Java Media Framework (JMF) classes from Sun (on Mac OS X use the cross-platform download). Put jmf.jar in your system's classpath, e.g. on Mac OS X that can be /Library/Java/Extensions. I'm hoping to find a better solution for movie playback in the future.

launching the server

Open a terminal and cd into the SwingOSC folder. Either run the default script by typing sh SwingOSC.sh, or launch with custom options:

   > java [java-VM-options] -jar build/SwingOSC.jar [swing-osc-options]

where the VM options are:

and the SwingOSC options are:

if you wish to include custom java classes or libraries, you can either

documentation / usage

Please read the DevelopersNeeded note.

compilation

The source code can be compiled using Eclipse SDK 3.2+ (www.eclipse.org) and Apache Ant 1.6.5+ (ant.apache.org). You need to install Ant-Contrib as well (first install Ant if you do not have it, then download Ant-Contrib and copy ant-contrib.jar into Ant's lib folder). The Eclipse project file is configured to run the regular Ant build file. You can make a clean build just with Ant from the terminal:

> ant clean jar
> ant test

The "test" will just launch SwingOSC so you can see if the build works; you can leave away that task. By default, NetUtil is included in the resulting file build/SwingOSC.jar. If wish to link externally to it, you can build like this:

> ant -Dplain=true clean jar

To compile MovieView.java, you will need to have jmf.jar in your classpath (see requirements sections above). If JMF is not installed, the Ant build will skip the compilation of MovieView.java and you will not be able to use JSCMovieView.

known issues

to-do list

change history

v0.60 (may 2008 - SVN rev. 77)

v0.59 (feb 2008 - SVN rev. 56)

v0.58 (jan 2008 - SVN rev. 47)

v0.56 (oct 2007)

v0.55 (sep 2007)

v0.54 (jul 2007)

v0.53 (jul 2007)

v0.52 (apr 2007)

v0.513 (apr 2007)

v0.51 (mar 2007)

v0.50 (feb 2007)

v0.44 (dec 2006)

v0.43 (oct 2006)

v0.42 (oct 2006)

v0.41 (aug 2006)

v0.40 (apr 2006)

v0.39 (mar 2006)

v0.38 (feb 2006)

v0.37 (feb 2006)

v0.36 (dec 2005)

v0.35 (dec 2005)

v0.3 (nov 2005)

v0.2 (aug 2005)


java is a trademark of sun microsystems
i think mac os and xcode are trademarks of apple inc
windows is one of microsoft corp
jever is a trademark of some west german beer factory