Read Me

Slipmat pre-alpha 0.01.0

Copyright 2008 by Jacob Joaquin
Licensed under GNU Lesser General Public License.  See "lgpl-3.0.txt"
http://sourceforge.net/projects/slipmat/


TABLE OF CONTENT:
	Introduction
	Dependencies
	Running the Examples with NetBeans (os x)
	Questions / Comments

--------------------------------------------------------------------------------
Introduction

Slipmat is a Java-based modular computer music library built on top of
the Csound API.

This is a pre-alpha release of Slipmat.  Everything is still in flux.
So while you can use it, classes and methods will certainly change. Over
the next few months, a specification will arise, and things will settle
a bit.

For more information, read "Introducing Slipmat for Java and Csound":

http://www.thumbuki.com/20080530/introducing-slipmat-for-java-and-csound.html


--------------------------------------------------------------------------------
Dependencies

In order to use this package, you will require the Java Csound API.  On
Mac OS X, it comes by default with the Mac OS X release of Csound.  At
the moment, I am unaware of how to run this software on other operating
systems.  You can download Csound at:

http://csound.sourceforge.net/

You will need the csnd jar file to your build path.  On OS X, this jar
is located at:

/Library/Frameworks/CsoundLib.framework/Resources/java/csnd.jar


--------------------------------------------------------------------------------
Running the Examples with NetBeans (os x)

Here is a quick guide to setting up slipmat on NetBeans 6.1.  You can download
NetBeans at:

http://www.netbeans.org/

Open NetBeans.
File->New Project
Choose "Java Project from Existing Source"
Browse for the Slipmat folder.
Set the Project Name to Slipmat.
Click next.
Click Add Folder.
Double click "src" and click open.
Click next.
Click Finish.
Left click Slipmat in the Project window (apple-1 if not opened) and
    select properties in the pop-up menu.
Select Libraries on the left.
Click Add JAR/Folder.
Browse for csnd.jar located at:
    /Library/Frameworks/CsoundLib.framework/Resources/java/csnd.jar
Click choose.
Click OK.
In the Project window, unfold src->com.thumbuki.slipmat.examples
Double click SimpleExample.java.
Run SimpleExample with shift-f6.
Repeat for the other examples.

--------------------------------------------------------------------------------
Questions / Comments

If you have questions, post to the slipmat forums at sourceforge, at 
csounds.com, or you can post to the Csound Mailing List:

http://www.nabble.com/Csound-f480.html






More examples and tutorials are on their way...