1 |
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>JSampler Manual</title><link rel="stylesheet" href="jsampler.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="id249551"></a>JSampler Manual</h1></div><div><div class="author"><h3 class="author"><span class="firstname">by Grigor</span> <span class="surname">Iliev</span></h3></div></div><div><p class="copyright">Copyright © 2007 Grigor Iliev <grigor@grigoriliev.com></p></div><div><div class="legalnotice"><a name="id257667"></a><p>This document is released under the terms of the <a href="gfdl.html" target="_top">GNU Free Documentation License</a>.</p></div></div><div><p class="pubdate">Updated: Mon, 2 Apr 2007</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#id249707">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id249712">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id249760">What is a JSampler distribution?</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id249967">2. Screenshots</a></span></dt><dt><span class="chapter"><a href="#id249994">3. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#id250002">What to download?</a></span></dt><dt><span class="section"><a href="#id250145">Requirements</a></span></dt><dt><span class="section"><a href="#id250175">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250286">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250308">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250385">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250449">Running JSampler on Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id251445">4. Building from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id251461">Building from CVS</a></span></dt><dt><span class="section"><a href="#id251537">Compilation</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249707"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id249712">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id249760">What is a JSampler distribution?</a></span></dt></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id249712"></a>What is JSampler?</h2></div></div></div><p>JSampler is an opensource, platform-independent, GUI front-end for |
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>JSampler Manual</title><link rel="stylesheet" href="jsampler.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="id249551"></a>JSampler Manual</h1></div><div><div class="author"><h3 class="author"><span class="firstname">by Grigor</span> <span class="surname">Iliev</span></h3></div></div><div><p class="copyright">Copyright © 2007 Grigor Iliev <grigor@grigoriliev.com></p></div><div><div class="legalnotice"><a name="id257667"></a><p>This document is released under the terms of the <a href="gfdl.html" target="_top">GNU Free Documentation License</a>.</p></div></div><div><p class="pubdate">Updated: Thu, 17 May 2007</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#id249707">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id249712">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id249760">What is a JSampler distribution?</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id249967">2. Screenshots</a></span></dt><dt><span class="chapter"><a href="#id249994">3. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#id250002">What to download?</a></span></dt><dt><span class="section"><a href="#id250145">Requirements</a></span></dt><dt><span class="section"><a href="#id250175">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250286">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250308">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250385">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250449">Running JSampler on Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id251445">4. Building from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id251461">Building from CVS</a></span></dt><dt><span class="section"><a href="#id251537">Compilation</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249707"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id249712">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id249760">What is a JSampler distribution?</a></span></dt></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id249712"></a>What is JSampler?</h2></div></div></div><p>JSampler is an opensource, platform-independent, GUI front-end for |
2 |
<a href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written |
<a href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written |
3 |
entirely in <a href="http://java.sun.com" target="_top">Java</a>. The main goal |
entirely in <a href="http://java.sun.com" target="_top">Java</a>. The main goal |
4 |
of the JSampler's design is to be extensible and more flexible regarding |
of the JSampler's design is to be extensible and more flexible regarding |
25 |
toolbars</p><div><img src="images/js-classic2.png"></div><p>Fantasia</p><div><img src="images/fantasia.png"></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249994"></a>Chapter 3. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id250002">What to download?</a></span></dt><dt><span class="section"><a href="#id250145">Requirements</a></span></dt><dt><span class="section"><a href="#id250175">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250286">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250308">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250385">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250449">Running JSampler on Windows</a></span></dt></dl></div><p></p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250002"></a>What to download?</h2></div></div></div><p>Currently, there are two distributions available for download - JS |
toolbars</p><div><img src="images/js-classic2.png"></div><p>Fantasia</p><div><img src="images/fantasia.png"></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249994"></a>Chapter 3. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id250002">What to download?</a></span></dt><dt><span class="section"><a href="#id250145">Requirements</a></span></dt><dt><span class="section"><a href="#id250175">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250286">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250308">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250385">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250449">Running JSampler on Windows</a></span></dt></dl></div><p></p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250002"></a>What to download?</h2></div></div></div><p>Currently, there are two distributions available for download - JS |
26 |
Classic and Fantasia. However, for now the preferred choice is JS |
Classic and Fantasia. However, for now the preferred choice is JS |
27 |
Classic, because Fantasia is only partially implemented. The latest |
Classic, because Fantasia is only partially implemented. The latest |
28 |
version of JS Classic is available for download from <a href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.4a.jar" target="_top">here</a>.</p><p>The source code is available in the <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.4a.tar.bz2" target="_top">JSampler |
version of JS Classic is available for download from <a href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.5a.jar" target="_top">here</a>.</p><p>The source code is available in the <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.5a.tar.bz2" target="_top">JSampler |
29 |
package</a>, which also contains this manual and startup scripts |
package</a>, which also contains this manual and startup scripts |
30 |
that can be used to run a particular JSampler distribution.</p><p>The latest source code can be obtained from cvs with the following |
that can be used to run a particular JSampler distribution.</p><p>The latest source code can be obtained from cvs with the following |
31 |
command:</p><p><span><strong class="command">cvs -z3 |
command:</p><p><span><strong class="command">cvs -z3 |
32 |
-d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co |
-d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co |
33 |
jsampler</strong></span></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250145"></a>Requirements</h2></div></div></div><p>To run JSampler you need Java Runtime Environment (JRE) version 5 |
jsampler</strong></span></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250145"></a>Requirements</h2></div></div></div><p>To run JSampler you need Java Runtime Environment (JRE) version 6 |
34 |
or higher. The latest version can be downloaded from <a href="http://java.sun.com/javase/downloads/" target="_top">here</a>.</p><p>To build JSampler distribution from source you need JDK version |
or higher. The latest version can be downloaded from <a href="http://java.sun.com/javase/downloads/" target="_top">here</a>.</p><p>To build JSampler distribution from source you need JDK version |
35 |
5.0 or higher and the <a href="http://ant.apache.org/" target="_top">Ant |
6.0 or higher and the <a href="http://ant.apache.org/" target="_top">Ant |
36 |
tool</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250175"></a>Running a JSampler distribution</h2></div></div></div><p>Let's assume that you want to run from the command line |
tool</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250175"></a>Running a JSampler distribution</h2></div></div></div><p>Let's assume that you want to run from the command line |
37 |
<code class="code">JS_Classic-0.4a.jar</code>, which is located in |
<code class="code">JS_Classic-0.5a.jar</code>, which is located in |
38 |
<code class="code">/home/me/soft</code> directory. First you should check whether the |
<code class="code">/home/me/soft</code> directory. First you should check whether the |
39 |
<code class="code">java</code> command is in your path and the version requirements |
<code class="code">java</code> command is in your path and the version requirements |
40 |
are met. This can be done by issuing the following command:</p><p><span><strong class="command">java -version</strong></span></p><p>If the version is 1.5.0 or higher you can run JS Classic by |
are met. This can be done by issuing the following command:</p><p><span><strong class="command">java -version</strong></span></p><p>If the version is 1.6.0 or higher you can run JS Classic by |
41 |
issuing the following command:</p><p><span><strong class="command">java -jar |
issuing the following command:</p><p><span><strong class="command">java -jar |
42 |
/home/me/soft/JS_Classic-0.4a.jar</strong></span></p><p>Otherwise, if the shell response is something like</p><p><span><strong class="command">bash: java: command not found</strong></span></p><p>or the version requirements are not met, make sure that you have |
/home/me/soft/JS_Classic-0.5a.jar</strong></span></p><p>Otherwise, if the shell response is something like</p><p><span><strong class="command">bash: java: command not found</strong></span></p><p>or the version requirements are not met, make sure that you have |
43 |
installed JRE (or JDK) with the proper version and find its |
installed JRE (or JDK) with the proper version and find its |
44 |
location:</p><div class="literallayout"><p><span><strong class="command">updatedb<br> |
location:</p><div class="literallayout"><p><span><strong class="command">updatedb<br> |
45 |
locate bin/java</strong></span></p></div><p>The shell should return something like:</p><div class="literallayout"><p><span><strong class="command">/opt/jdk1.6.0/bin/java<br> |
locate bin/java</strong></span></p></div><p>The shell should return something like:</p><div class="literallayout"><p><span><strong class="command">/opt/jdk1.6.0/bin/java<br> |
51 |
/usr/bin/java</strong></span></p></div><p>Now, we know that we have a JDK with a proper version installed |
/usr/bin/java</strong></span></p></div><p>Now, we know that we have a JDK with a proper version installed |
52 |
and its location is <code class="code">/opt/jdk1.6.0</code>. In that case, to run JS |
and its location is <code class="code">/opt/jdk1.6.0</code>. In that case, to run JS |
53 |
Classic issue the following command:</p><p><span><strong class="command">/opt/jdk1.6.0/bin/java -jar |
Classic issue the following command:</p><p><span><strong class="command">/opt/jdk1.6.0/bin/java -jar |
54 |
/home/me/soft/JS_Classic-0.4a.jar</strong></span></p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>On some systems double clicking on the jar file will be |
/home/me/soft/JS_Classic-0.5a.jar</strong></span></p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>On some systems double clicking on the jar file will be |
55 |
enough.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250286"></a>Using a script to run a JSampler distribution</h2></div></div></div><p>There are scripts In the <code class="code">scripts</code> directory of the |
enough.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250286"></a>Using a script to run a JSampler distribution</h2></div></div></div><p>There are scripts In the <code class="code">scripts</code> directory of the |
56 |
<a href="http://downloads.sourceforge.net/jsampler/JSampler-0.4a.tar.bz2" target="_top">JSampler |
<a href="http://downloads.sourceforge.net/jsampler/JSampler-0.5a.tar.bz2" target="_top">JSampler |
57 |
package</a> that, with a little adjustments (if needed), can be used |
package</a> that, with a little adjustments (if needed), can be used |
58 |
to run a JSampler distribution. Copy them to a desired location and edit |
to run a JSampler distribution. Copy them to a desired location and edit |
59 |
with your preferred editor.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250308"></a>Telling Gnome how to handle jar files</h2></div></div></div><p>This configuration is optional, but necessary if you want to run |
with your preferred editor.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250308"></a>Telling Gnome how to handle jar files</h2></div></div></div><p>This configuration is optional, but necessary if you want to run |
85 |
<code class="code">lib/required</code> directory in the JSampler root and copy the |
<code class="code">lib/required</code> directory in the JSampler root and copy the |
86 |
<code class="code">jlscp.jar</code> and <code class="code">juife.jar</code> files in that |
<code class="code">jlscp.jar</code> and <code class="code">juife.jar</code> files in that |
87 |
directory:</p><div class="literallayout"><p><span><strong class="command">cd /home/me/soft<br> |
directory:</p><div class="literallayout"><p><span><strong class="command">cd /home/me/soft<br> |
88 |
wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.4a.tar.bz2<br> |
wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.5a.tar.bz2<br> |
89 |
tar -xjf jlscp-0.4a.tar.bz2<br> |
tar -xjf jlscp-0.5a.tar.bz2<br> |
90 |
wget -c http://downloads.sourceforge.net/juife/juife-0.4a.tar.bz2<br> |
wget -c http://downloads.sourceforge.net/juife/juife-0.4a.tar.bz2<br> |
91 |
tar -xjf juife-0.4a.tar.bz2<br> |
tar -xjf juife-0.4a.tar.bz2<br> |
92 |
cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler<br> |
cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler<br> |
93 |
cd jsampler<br> |
cd jsampler<br> |
94 |
mkdirhier lib/required<br> |
mkdirhier lib/required<br> |
95 |
cp ../jlscp-0.4a/lib/jlscp.jar lib/required/jlscp.jar<br> |
cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar<br> |
96 |
cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar</strong></span></p></div><p>Then follow the steps in the next section.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id251537"></a>Compilation</h2></div></div></div><p>To build a JSampler distribution, first set the |
cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar</strong></span></p></div><p>Then follow the steps in the next section.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id251537"></a>Compilation</h2></div></div></div><p>To build a JSampler distribution, first set the |
97 |
<code class="code">JAVA_HOME</code> environment variable to point to your JDK |
<code class="code">JAVA_HOME</code> environment variable to point to your JDK |
98 |
directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can |
directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can |