/[svn]/web/trunk/www.linuxsampler.org/jsampler/manual/html/jsampler.html
ViewVC logotype

Diff of /web/trunk/www.linuxsampler.org/jsampler/manual/html/jsampler.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1202 by iliev, Mon Apr 2 21:58:21 2007 UTC revision 1203 by iliev, Thu May 24 21:19:36 2007 UTC
# Line 1  Line 1 
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 &lt;grigor@grigoriliev.com&gt;</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 &lt;grigor@grigoriliev.com&gt;</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
# Line 25  Line 25 
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>
# Line 51  locate bin/java</strong></span></p></div Line 51  locate bin/java</strong></span></p></div
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
# Line 85  locate bin/java</strong></span></p></div Line 85  locate bin/java</strong></span></p></div
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

Legend:
Removed from v.1202  
changed lines
  Added in v.1203

  ViewVC Help
Powered by ViewVC