WOscLib Documentation

00.11

Introduction

This is the documentation of the Weiss OSC Library (WOscLib). WOscLib is a complete (server and client), easy to use OSC (OpenSound-Control) library, featuring Object Oriented (C++) design (modularity), platform independence, type-safety (especially in OSC-methods), exception-handling and good documentation (doxygen).

This library is the result of the development of an OSC system at Weiss Engineering LTD. in Switzerland. DWE likes to share its knowledge and team up with other developers to maintain an enhanceable library, accessible through a global cvs or similar version control system.

Implementation

This work is a re-implementation and (hopefully) modernization of the the classic OSC-Kit, which was originally provided by Matt-Wright and was written in pure C (see http://www.cnmat.berkeley.edu/OpenSoundControl).

Matt's kit uses lots of global variables, a fast but user-unfriendly memory-allocation (and de-allocation)-scheme, makes use of non type-save osc-callback-functions, has no real exception handling and its modularity is heavily restricted due to the C-design. There is also no documentation based on a modern auto-doc-system (e.g. doxygen) what makes it harder for newbies to get an OSC-system running in 10 minutes since they have to read all (or at least some) source-files first.

Summary of the reasons of the re-implementation are:

Platforms

Currently supported platforms are:

Acknowledgements

The authors like to thank Matt Wright for his OSC-Kit, Daniel Weiss for his consent to make this library open-source and all contributors.

Copyright


 WOscLib, an object oriented OSC library.
 Copyright (C) 2005 Uli Clemens Franke, Weiss Engineering LTD, Switzerland.
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
 License as published by the Free Software Foundation; either
 version 2.1 of the License, or (at your option) any later version.
 
 This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 Lesser General Public License for more details.
 
 You should have received a copy of the GNU Lesser General Public
 License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

 

See LGPL for details.

Parts of the library are based on work of Matt Wright. His code is included under the following copyright:


 Copyright � 1998. The Regents of the University of California (Regents). 
 All Rights Reserved.

 Written by Matt Wright, The Center for New Music and Audio Technologies,
 University of California, Berkeley.

 Permission to use, copy, modify, distribute, and distribute modified versions
 of this software and its documentation without fee and without a signed
 licensing agreement, is hereby granted, provided that the above copyright
 notice, this paragraph and the following two paragraphs appear in all copies,
 modifications, and distributions.

 IN NO EVENT SHALL REGENTS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
 SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING
 OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF REGENTS HAS
 BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 REGENTS SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 PURPOSE. THE SOFTWARE AND ACCOMPANYING DOCUMENTATION, IF ANY, PROVIDED
 HEREUNDER IS PROVIDED "AS IS". REGENTS HAS NO OBLIGATION TO PROVIDE
 MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

 
Generated on Sat Oct 23 03:05:59 2010 for WOscLib by  doxygen 1.6.3