/[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 1446 by iliev, Fri Aug 10 22:29:53 2007 UTC revision 1447 by iliev, Mon Oct 15 21:37:32 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: 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  <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.73.2"></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="id231363"></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="id282616"></a><p>This document is released under the terms of the <a class="ulink" 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="#id282270">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id282276">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id282323">What is a JSampler distribution?</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id281876">2. Screenshots</a></span></dt><dt><span class="chapter"><a href="#id281919">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="#id281608">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id281631">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id326615">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id326782">Running JSampler on Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="#id326815">4. Building from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id326832">Building from CVS</a></span></dt><dt><span class="section"><a href="#id326908">Compilation</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id282270"></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="#id282276">What is JSampler?</a></span></dt><dt><span class="section"><a href="#id282323">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="id282276"></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 class="ulink" 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 class="ulink" 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
5        the integration of different GUI implementations. JSampler consists of        the integration of different GUI implementations. JSampler consists of
6        two parts:</p><div class="itemizedlist"><ul type="disc"><li><p>JSampler core - handles the LSCP command processing and        two parts:</p><div class="itemizedlist"><ul type="disc"><li><p>JSampler core - handles the LSCP command processing and
# Line 11  Line 11 
11              provides the user interface part of JSampler.</p></li></ul></div><p>The main reason for that is the TCP/IP based              provides the user interface part of JSampler.</p></li></ul></div><p>The main reason for that is the TCP/IP based
12        communication between the LinuxSampler and its front-ends, enabling the        communication between the LinuxSampler and its front-ends, enabling the
13        sampler to be controlled from another computer or device, which may have        sampler to be controlled from another computer or device, which may have
14        different display requirements and limitations.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id249760"></a>What is a JSampler distribution?</h2></div></div></div><p>A JSampler distribution consist of the JSampler core and at least        different display requirements and limitations.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id282323"></a>What is a JSampler distribution?</h2></div></div></div><p>A JSampler distribution consist of the JSampler core and at least
15        one view, providing the GUI implementation. Each distribution has its        one view, providing the GUI implementation. Each distribution has its
16        own name, which is based on the integrated view extension. Currently,        own name, which is based on the integrated view extension. Currently,
17        there are two distributions:</p><div class="itemizedlist"><ul type="disc"><li><p>JS Classic - A distribution with a standard GUI, capable of        there are two distributions:</p><div class="itemizedlist"><ul type="disc"><li><p>JS Classic - A distribution with a standard GUI, capable of
# Line 19  Line 19 
19              this writing. JS Classic also provides some additional features to              this writing. JS Classic also provides some additional features to
20              facilitate the every day work with the sampler and to automate the              facilitate the every day work with the sampler and to automate the
21              most frequently used configurations.</p></li><li><p>Fantasia - A distribution with a modern skin based view              most frequently used configurations.</p></li><li><p>Fantasia - A distribution with a modern skin based view
22              (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              (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="id281876"></a>Chapter 2. Screenshots</h2></div></div></div><p>JS Classic with left pane, LS console, statusbar and toolbars</p><p><a class="ulink" 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
23      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><p><a class="ulink" href="images/js-classic2.png" target="_top"><img src="images/js-classic2-preview.png"></a></p><p>Fantasia</p><p><a class="ulink" 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="id281919"></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="#id281608">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#id281631">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#id326615">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#id326782">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 -
24        <a href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.6a.jar" target="_top">JS        <a class="ulink" href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.7a.jar" target="_top">JS
25        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</a> and <a class="ulink" href="http://downloads.sourceforge.net/jsampler/Fantasia-0.7a.jar" target="_top">Fantasia</a>.</p><p>The source code is available in the <a class="ulink" href="http://downloads.sourceforge.net/jsampler/JSampler-0.7a.tar.bz2" target="_top">JSampler
26        package</a>, which also contains this manual and startup scripts        package</a>, which also contains this manual and startup scripts
27        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
28        command:</p><p><span><strong class="command">cvs -z3        command:</p><p><span class="command"><strong>cvs -z3
29        -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co        -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co
30        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        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
31        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 class="ulink" href="http://java.sun.com/javase/downloads/" target="_top">here</a>.</p><p>To build JSampler distribution from source you need JDK version
32        6.0 or higher and the <a href="http://ant.apache.org/" target="_top">Ant        6.0 or higher and the <a class="ulink" href="http://ant.apache.org/" target="_top">Ant
33        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        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
34        <code class="code">JS_Classic-0.6a.jar</code>, which is located in        <code class="code">JS_Classic-0.6a.jar</code>, which is located in
35        <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
36        <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
37        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        are met. This can be done by issuing the following command:</p><p><span class="command"><strong>java -version</strong></span></p><p>If the version is 1.6.0 or higher you can run JS Classic by
38        issuing the following command:</p><p><span><strong class="command">java -jar        issuing the following command:</p><p><span class="command"><strong>java -jar
39        /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        /home/me/soft/JS_Classic-0.6a.jar</strong></span></p><p>Otherwise, if the shell response is something like</p><p><span class="command"><strong>bash: java: command not found</strong></span></p><p>or the version requirements are not met, make sure that you have
40        installed JRE (or JDK) with the proper version and find its        installed JRE (or JDK) with the proper version and find its
41        location:</p><div class="literallayout"><p><span><strong class="command">updatedb<br>        location:</p><div class="literallayout"><p><span class="command"><strong>updatedb<br>
42  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 class="command"><strong>/opt/jdk1.6.0/bin/java<br>
43  /opt/jdk1.6.0/bin/javac<br>  /opt/jdk1.6.0/bin/javac<br>
44  /opt/jdk1.6.0/bin/javadoc<br>  /opt/jdk1.6.0/bin/javadoc<br>
45  /opt/jdk1.6.0/bin/javah<br>  /opt/jdk1.6.0/bin/javah<br>
# Line 47  locate bin/java</strong></span></p></div Line 47  locate bin/java</strong></span></p></div
47  /opt/jdk1.6.0/jre/bin/java<br>  /opt/jdk1.6.0/jre/bin/java<br>
48  /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
49        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
50        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 class="command"><strong>/opt/jdk1.6.0/bin/java -jar
51        /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        /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
52            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            enough.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id281608"></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
53        <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.6a.tar.bz2" target="_top">JSampler        <a class="ulink" href="http://downloads.sourceforge.net/jsampler/JSampler-0.7a.tar.bz2" target="_top">JSampler
54        package</a> that, with a little adjustments (if needed), can be used        package</a> that, with a little adjustments (if needed), can be used
55        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
56        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        with your preferred editor.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id281631"></a>Telling Gnome how to handle jar files</h2></div></div></div><p>This configuration is optional, but necessary if you want to run
57        jar files by (double) clicking on them. In Gnome, by default jar files        jar files by (double) clicking on them. In Gnome, by default jar files
58        are opened with the Archive Manager. To change that, run a file browser,        are opened with the Archive Manager. To change that, run a file browser,
59        right click on an arbitrary jar file and choose        right click on an arbitrary jar file and choose
# Line 62  locate bin/java</strong></span></p></div Line 62  locate bin/java</strong></span></p></div
62        button.</p><div><img src="images/file-properties.png"></div><p>In the <span class="guilabel">Add Application</span> dialog click onto        button.</p><div><img src="images/file-properties.png"></div><p>In the <span class="guilabel">Add Application</span> dialog click onto
63        <span class="guilabel">Use a custom command</span> label and a text field will        <span class="guilabel">Use a custom command</span> label and a text field will
64        appear below. If the location of your JRE is <code class="code">/opt/jre1.6.0</code>,        appear below. If the location of your JRE is <code class="code">/opt/jre1.6.0</code>,
65        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        then enter the following command in the text box:</p><p><span class="command"><strong>/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="id326615"></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
66        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        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
67        click the <span class="guibutton">Add</span> button. In the        click the <span class="guibutton">Add</span> button. In the
68        <span class="guilabel">Command</span> field, of the <span class="guilabel">Create        <span class="guilabel">Command</span> field, of the <span class="guilabel">Create
69        Launcher</span> dialog, fill in the exact command that you use to        Launcher</span> dialog, fill in the exact command that you use to
70        run the JSampler. For more information on how to run a JSampler        run the JSampler. For more information on how to run a JSampler
71        distribution from the command line <a href="#running-js-dist" title="Running a JSampler distribution">click        distribution from the command line <a class="link" href="#running-js-dist" title="Running a JSampler distribution">click
72        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        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="id326782"></a>Running JSampler on Windows</h2></div></div></div><p>To run JSampler distribution on Windows, put a shortcut on the
73        Desktop or Quick Launch, right click on the shortcut and choose        Desktop or Quick Launch, right click on the shortcut and choose
74        <span class="guimenu">Properties</span>. In the <span class="guilabel">Target</span> field        <span class="guimenu">Properties</span>. In the <span class="guilabel">Target</span> field
75        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        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="id326815"></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="#id326832">Building from CVS</a></span></dt><dt><span class="section"><a href="#id326908">Compilation</a></span></dt></dl></div><p>If you want to build a JSampler distribution from source, first make
76      sure that all <a href="#requirements" title="Requirements">requirements</a> are      sure that all <a class="link" href="#requirements" title="Requirements">requirements</a> are
77      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      met.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id326832"></a>Building from CVS</h2></div></div></div><p>When building from CVS, there are some additional steps that
78        should be done. JSampler uses two additional libraries, that should be        should be done. JSampler uses two additional libraries, that should be
79        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        downloaded and placed in the <code class="code">lib/required</code> directory:</p><div class="itemizedlist"><ul type="disc"><li><p><a class="ulink" href="http://sourceforge.net/projects/jlscp/" target="_top">jlscp</a> - A
80              java LinuxSampler control protocol API</p></li><li><p><a href="http://sourceforge.net/projects/juife/" target="_top">juife</a> - Java              java LinuxSampler control protocol API</p></li><li><p><a class="ulink" href="http://sourceforge.net/projects/juife/" target="_top">juife</a> - Java
81              User Interface Framework Extensions</p></li></ul></div><p>Download these libraries, create a              User Interface Framework Extensions</p></li></ul></div><p>Download these libraries, create a
82        <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
83        <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
84        directory:</p><div class="literallayout"><p><span><strong class="command">cd /home/me/soft<br>        directory:</p><div class="literallayout"><p><span class="command"><strong>cd /home/me/soft<br>
85  wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.5a.tar.bz2<br>  wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.5a.tar.bz2<br>
86  tar -xjf jlscp-0.5a.tar.bz2<br>  tar -xjf jlscp-0.5a.tar.bz2<br>
87  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>
# Line 90  cvs -z3 -d:pserver:anonymous@cvs.linuxsa Line 90  cvs -z3 -d:pserver:anonymous@cvs.linuxsa
90  cd jsampler<br>  cd jsampler<br>
91  mkdirhier lib/required<br>  mkdirhier lib/required<br>
92  cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar<br>  cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar<br>
93  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  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="id326908"></a>Compilation</h2></div></div></div><p>To build a JSampler distribution, first set the
94        <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
95        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
96        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        be done by issuing the following command:</p><p><span class="command"><strong>export JAVA_HOME=/opt/jdk1.6.0</strong></span></p><p>Windows users should do something like:</p><p><span class="command"><strong>set JAVA_HOME=c:\jdk1.6.0</strong></span></p><p>Go to the JSampler root directory and issue the following
97        command:</p><p><span><strong class="command">ant [target]</strong></span></p><p>Where <code class="code">target</code> can be one of the following:</p><div class="itemizedlist"><ul type="disc"><li><p><span><strong class="command">build-jsclassic</strong></span> - Builds a JS Classic        command:</p><p><span class="command"><strong>ant [target]</strong></span></p><p>Where <code class="code">target</code> can be one of the following:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="command"><strong>build-jsclassic</strong></span> - Builds a JS Classic
98              distribution.</p></li><li><p><span><strong class="command">clean-jsclassic</strong></span> - Removes the JS Classic              distribution.</p></li><li><p><span class="command"><strong>clean-jsclassic</strong></span> - Removes the JS Classic
99              distribution.</p></li><li><p><span><strong class="command">build-fantasia</strong></span> - Builds a Fantasia              distribution.</p></li><li><p><span class="command"><strong>build-fantasia</strong></span> - Builds a Fantasia
100              distribution.</p></li><li><p><span><strong class="command">clean-fantasia</strong></span> - Removes the Fantasia              distribution.</p></li><li><p><span class="command"><strong>clean-fantasia</strong></span> - Removes the Fantasia
101              distribution.</p></li><li><p><span><strong class="command">build-coredoc</strong></span> - Generates the API              distribution.</p></li><li><p><span class="command"><strong>build-coredoc</strong></span> - Generates the API
102              documentation for the JSampler core.</p></li><li><p><span><strong class="command">clean-coredoc</strong></span> - Removes the API              documentation for the JSampler core.</p></li><li><p><span class="command"><strong>clean-coredoc</strong></span> - Removes the API
103              documentation for the JSampler core.</p></li></ul></div><p>So, if you want to build a JS Classic distribution, just issue the              documentation for the JSampler core.</p></li></ul></div><p>So, if you want to build a JS Classic distribution, just issue the
104        following command:</p><p><span><strong class="command">ant build-jsclassic</strong></span></p><p>Then copy the jar file from the <code class="code">dist</code> directory to the        following command:</p><p><span class="command"><strong>ant build-jsclassic</strong></span></p><p>Then copy the jar file from the <code class="code">dist</code> directory to the
105        desired location.</p></div></div></div></body></html>        desired location.</p></div></div></div></body></html>

Legend:
Removed from v.1446  
changed lines
  Added in v.1447

  ViewVC Help
Powered by ViewVC