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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1447 - (show annotations) (download) (as text)
Mon Oct 15 21:37:32 2007 UTC (16 years, 5 months ago) by iliev
File MIME type: text/html
File size: 17809 byte(s)
- update for jsampler 0.7a release

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.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 class="ulink" href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written
3 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
5 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
7 event notifications, sent by LinuxSampler, and provides convenient
8 data models and controllers to be used instead. The core also
9 provides the necessary interfaces that should be implemented by
10 all JSamler views.</p></li><li><p>JSampler view - an extension to the JSampler core, which
11 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
13 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="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
16 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
18 controlling all features available in LinuxSampler at the time of
19 this writing. JS Classic also provides some additional features to
20 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
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="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 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 class="ulink" href="http://downloads.sourceforge.net/jsampler/JS_Classic-0.7a.jar" target="_top">JS
25 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
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
28 command:</p><p><span class="command"><strong>cvs -z3
29 -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
31 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 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
34 <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
36 <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 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 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 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
41 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 class="command"><strong>/opt/jdk1.6.0/bin/java<br>
43 /opt/jdk1.6.0/bin/javac<br>
44 /opt/jdk1.6.0/bin/javadoc<br>
45 /opt/jdk1.6.0/bin/javah<br>
46 /opt/jdk1.6.0/bin/javap<br>
47 /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
49 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 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
52 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 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
55 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="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
58 are opened with the Archive Manager. To change that, run a file browser,
59 right click on an arbitrary jar file and choose
60 <span class="guimenu">Properties</span>, than go to the <span class="guilabel">Open
61 With</span> tab and click the <span class="guibutton">Add</span>
62 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
64 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 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
67 click the <span class="guibutton">Add</span> button. In the
68 <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
70 run the JSampler. For more information on how to run a JSampler
71 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="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
74 <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="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 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="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
79 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 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
82 <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
84 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>
86 tar -xjf jlscp-0.5a.tar.bz2<br>
87 wget -c http://downloads.sourceforge.net/juife/juife-0.4a.tar.bz2<br>
88 tar -xjf juife-0.4a.tar.bz2<br>
89 cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler<br>
90 cd jsampler<br>
91 mkdirhier lib/required<br>
92 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="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
95 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 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 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 class="command"><strong>clean-jsclassic</strong></span> - Removes the JS Classic
99 distribution.</p></li><li><p><span class="command"><strong>build-fantasia</strong></span> - Builds a Fantasia
100 distribution.</p></li><li><p><span class="command"><strong>clean-fantasia</strong></span> - Removes the Fantasia
101 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 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
104 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>

  ViewVC Help
Powered by ViewVC