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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1203 by iliev,
Thu May 24 21:19:36 2007 UTC
+revision 1288 by iliev,
Fri Aug 10 22:29:53 2007 UTC
 Line 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: 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
+ <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: Fri, 10 August 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="#id250009">3. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#download">What to download?</a></span></dt><dt><span class="section"><a href="#requirements">Requirements</a></span></dt><dt><span class="section"><a href="#running-js-dist">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250311">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250333">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250410">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250474">Running JSampler on Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id251470">4. Building from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id251486">Building from CVS</a></span></dt><dt><span class="section"><a href="#id251562">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
        <a href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written
        entirely in <a href="http://java.sun.com" target="_top">Java</a>. The main goal
        of the JSampler's design is to be extensible and more flexible regarding
 Line 18
              controlling all features available in LinuxSampler at the time of
              this writing. JS Classic also provides some additional features to
              facilitate the every day work with the sampler and to automate the
-             most frequently used configurations.</p></li><li><p>Fantasia - A distribution with a skin based view, which is
+             most frequently used configurations.</p></li><li><p>Fantasia - A distribution with a modern skin based view
-             in early development stage and is only partially implemented
+             (initial graphic design by Olivier Boyer).</p></li></ul></div></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249967"></a>Chapter 2. Screenshots</h2></div></div></div><p>JS Classic with left pane, LS console, statusbar and toolbars</p><p><a href="images/js-classic1.png" target="_top"><img src="images/js-classic1-preview.png"></a></p><p>JS Classic without left pane, LS console, statusbar and
-             (graphic design by Olivier Boyer).</p></li></ul></div></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id249967"></a>Chapter 2. Screenshots</h2></div></div></div><p>JS Classic with left pane, LS console, statusbar and
+     toolbars</p><p><a href="images/js-classic2.png" target="_top"><img src="images/js-classic2-preview.png"></a></p><p>Fantasia</p><p><a href="images/fantasia.png" target="_top"><img src="images/fantasia-preview.png"></a></p></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id250009"></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="#download">What to download?</a></span></dt><dt><span class="section"><a href="#requirements">Requirements</a></span></dt><dt><span class="section"><a href="#running-js-dist">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250311">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id250333">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id250410">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id250474">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="download"></a>What to download?</h2></div></div></div><p>Currently, there are two distributions available for download -
-     toolbars</p><div><img src="images/js-classic1.png"></div><p>JS Classic without left pane, LS console, statusbar and
+       <a href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.6a.jar" target="_top">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
+       Classic</a> and <a href="http://downloads.sourceforge.net/jsampler/Fantasia-0.6a.jar" target="_top">Fantasia</a>.</p><p>The source code is available in the <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.6a.tar.bz2" target="_top">JSampler
-       Classic and Fantasia. However, for now the preferred choice is JS
-       Classic, because Fantasia is only partially implemented. The latest
-       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
        package</a>, which also contains this manual and startup scripts
        that can be used to run a particular JSampler distribution.</p><p>The latest source code can be obtained from cvs with the following
        command:</p><p><span><strong class="command">cvs -z3
        -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co
-       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
+       jsampler</strong></span></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="requirements"></a>Requirements</h2></div></div></div><p>To run JSampler you need Java Runtime Environment (JRE) version 6
        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
 .0 or higher and the <a href="http://ant.apache.org/" target="_top">Ant
-       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="running-js-dist"></a>Running a JSampler distribution</h2></div></div></div><p>Let's assume that you want to run from the command line
-       <code class="code">JS_Classic-0.5a.jar</code>, which is located in
+       <code class="code">JS_Classic-0.6a.jar</code>, which is located in
        <code class="code">/home/me/soft</code> directory. First you should check whether the
        <code class="code">java</code> command is in your path and the version requirements
        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
        issuing the following command:</p><p><span><strong class="command">java -jar
-       /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
+       /home/me/soft/JS_Classic-0.6a.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
        installed JRE (or JDK) with the proper version and find its
        location:</p><div class="literallayout"><p><span><strong class="command">updatedb<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 48 
 locate bin/java</strong></span></p></div
  /usr/bin/java</strong></span></p></div><p>Now, we know that we have a JDK with a proper version installed
        and its location is <code class="code">/opt/jdk1.6.0</code>. In that case, to run JS
        Classic issue the following command:</p><p><span><strong class="command">/opt/jdk1.6.0/bin/java -jar
-       /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
+       /home/me/soft/JS_Classic-0.6a.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
-           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="id250311"></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
-       <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.5a.tar.bz2" target="_top">JSampler
+       <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.6a.tar.bz2" target="_top">JSampler
        package</a> that, with a little adjustments (if needed), can be used
        to run a JSampler distribution. Copy them to a desired location and edit
-       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="id250333"></a>Telling Gnome how to handle jar files</h2></div></div></div><p>This configuration is optional, but necessary if you want to run
        jar files by (double) clicking on them. In Gnome, by default jar files
        are opened with the Archive Manager. To change that, run a file browser,
        right click on an arbitrary jar file and choose
-Line 65 
 locate bin/java</strong></span></p></div
+Line 62 
 locate bin/java</strong></span></p></div
        button.</p><div><img src="images/file-properties.png"></div><p>In the <span class="guilabel">Add Application</span> dialog click onto
        <span class="guilabel">Use a custom command</span> label and a text field will
        appear below. If the location of your JRE is <code class="code">/opt/jre1.6.0</code>,
-       then enter the following command in the text box:</p><p><span><strong class="command">/opt/jre1.6.0/bin/java -jar</strong></span></p><p>And then click the <span class="guibutton">Add</span> button.</p><div><img src="images/add-application.png"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250385"></a>Adding an application launcher to a Gnome panel</h2></div></div></div><p>To add an application launcher to a Gnome panel, right click on
+       then enter the following command in the text box:</p><p><span><strong class="command">/opt/jre1.6.0/bin/java -jar</strong></span></p><p>And then click the <span class="guibutton">Add</span> button.</p><div><img src="images/add-application.png"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250410"></a>Adding an application launcher to a Gnome panel</h2></div></div></div><p>To add an application launcher to a Gnome panel, right click on
        the panel and choose <span class="guimenu">Add to Panel</span>.</p><div><img src="images/add-to-panel.png"></div><p>Then select <span class="guilabel">Custom Application Launcher</span> and
        click the <span class="guibutton">Add</span> button. In the
        <span class="guilabel">Command</span> field, of the <span class="guilabel">Create
        Launcher</span> dialog, fill in the exact command that you use to
        run the JSampler. For more information on how to run a JSampler
-       distribution from the command line <a href="#running-js-dist">click
+       distribution from the command line <a href="#running-js-dist" title="Running a JSampler distribution">click
-       here</a>.</p><div><img src="images/add-to-panel-create-launcher.png"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250449"></a>Running JSampler on Windows</h2></div></div></div><p>To run JSampler distribution on Windows, put a shortcut on the
+       here</a>.</p><div><img src="images/add-to-panel-create-launcher.png"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id250474"></a>Running JSampler on Windows</h2></div></div></div><p>To run JSampler distribution on Windows, put a shortcut on the
        Desktop or Quick Launch, right click on the shortcut and choose
        <span class="guimenu">Properties</span>. In the <span class="guilabel">Target</span> field
-       insert the command <code class="code">javaw -jar</code> in the beginning.</p><div><img src="images/win-shortcut.png"></div></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id251445"></a>Chapter 4. Building from source</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><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></div><p>If you want to build a JSampler distribution from source, first make
+       insert the command <code class="code">javaw -jar</code> in the beginning.</p><div><img src="images/win-shortcut.png"></div></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id251470"></a>Chapter 4. Building from source</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id251486">Building from CVS</a></span></dt><dt><span class="section"><a href="#id251562">Compilation</a></span></dt></dl></div><p>If you want to build a JSampler distribution from source, first make
-     sure that all <a href="#requirements">requirements</a> are
+     sure that all <a href="#requirements" title="Requirements">requirements</a> are
-     met.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id251461"></a>Building from CVS</h2></div></div></div><p>When building from CVS, there are some additional steps that
+     met.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id251486"></a>Building from CVS</h2></div></div></div><p>When building from CVS, there are some additional steps that
        should be done. JSampler uses two additional libraries, that should be
        downloaded and placed in the <code class="code">lib/required</code> directory:</p><div class="itemizedlist"><ul type="disc"><li><p><a href="http://sourceforge.net/projects/jlscp/" target="_top">jlscp</a> - A
              java LinuxSampler control protocol API</p></li><li><p><a href="http://sourceforge.net/projects/juife/" target="_top">juife</a> - Java
-Line 93 
 cvs -z3 -d:pserver:anonymous@cvs.linuxsa
+Line 90 
 cvs -z3 -d:pserver:anonymous@cvs.linuxsa
  cd jsampler<br>
  mkdirhier lib/required<br>
  cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar<br>
- 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="id251562"></a>Compilation</h2></div></div></div><p>To build a JSampler distribution, first set the
        <code class="code">JAVA_HOME</code> environment variable to point to your JDK
        directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can
        be done by issuing the following command:</p><p><span><strong class="command">export JAVA_HOME=/opt/jdk1.6.0</strong></span></p><p>Windows users should do something like:</p><p><span><strong class="command">set JAVA_HOME=c:\jdk1.6.0</strong></span></p><p>Go to the JSampler root directory and issue the following

 Legend:



Removed from v.1203
 


changed lines


 
Added in v.1288
 Legend:



Removed from v.1203
 


changed lines


 
Added in v.1288
-Removed from v.1203
+Added in v.1288

	ViewVC Help
Powered by ViewVC