/[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 1146 by iliev,
Mon Apr  2 21:58:21 2007 UTC
+revision 1759 by iliev,
Tue Aug 26 21:07:23 2008 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: 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="id2423980"></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 © 2008 Grigor Iliev &lt;grigor@grigoriliev.com&gt;</p></div><div><div class="legalnotice"><a name="id2507296"></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: Tue, 26 August 2008</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#INTRODUCTION">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#WHAT_IS_JSAMPLER">What is JSampler?</a></span></dt><dt><span class="section"><a href="#WHAT_IS_JSAMPLER_DISTRIBUTION">What is a JSampler distribution?</a></span></dt></dl></dd><dt><span class="chapter"><a href="#SCREENSHOTS">2. Screenshots</a></span></dt><dt><span class="chapter"><a href="#INSTALLATION">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_JSAMPLER">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#USING_SCRIPT">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#GNOME_JAR_ASSOCIATIONS">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#GNOME_LAUNCHER">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#RUNING_ON_WINDOWS">Running JSampler on Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="#BUILDING_FROM_SOURCE">4. Building from source</a></span></dt><dd><dl><dt><span class="section"><a href="#BUILDING_FROM_CVS">Building from CVS</a></span></dt><dt><span class="section"><a href="#COMPILATION">Compilation</a></span></dt></dl></dd><dt><span class="chapter"><a href="#USING_ORCHESTRAS">5. Using Orchestras</a></span></dt><dd><dl><dt><span class="section"><a href="#MANAGING_ORCHESTRAS">Managing Orchestras</a></span></dt><dt><span class="section"><a href="#MANAGING_INSTRUMENTS">Managing Instruments</a></span></dt><dt><span class="section"><a href="#LOADING_ORCHESTRA_INSTRUMENTS">Loading Instruments</a></span></dt></dl></dd><dt><span class="chapter"><a href="#MIDI_INSTRUMENTS">6. MIDI Instruments</a></span></dt><dd><dl><dt><span class="section"><a href="#id2479911">Managing MIDI Instrument Maps</a></span></dt><dt><span class="section"><a href="#id2480012">Managing MIDI Instruments</a></span></dt><dt><span class="section"><a href="#id2480118">Assigning MIDI Instrument Map To Sampler Channel</a></span></dt></dl></dd><dt><span class="chapter"><a href="#INSTRUMENTS_DATABASE">7. Instruments Database</a></span></dt><dd><dl><dt><span class="section"><a href="#id2480256">Adding Instruments To The Instruments Database</a></span></dt><dt><span class="section"><a href="#id2480326">Manging Instruments And Directories</a></span></dt><dt><span class="section"><a href="#id2480489">Loading Instruments From The Instruments Database</a></span></dt><dt><span class="section"><a href="#INSTRUMENTS_DB_ADD_TO_MAP">Adding Instruments To MIDI Instrument Map</a></span></dt><dt><span class="section"><a href="#id2480561">Adding Instruments To Orchestra From The Instruments
+       Database</a></span></dt><dt><span class="section"><a href="#id2480604">Finding Instruments</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="INTRODUCTION"></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="#WHAT_IS_JSAMPLER">What is JSampler?</a></span></dt><dt><span class="section"><a href="#WHAT_IS_JSAMPLER_DISTRIBUTION">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="WHAT_IS_JSAMPLER"></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 11
+Line 12
              provides the user interface part of JSampler.</p></li></ul></div><p>The main reason for that is the TCP/IP based
        communication between the LinuxSampler and its front-ends, enabling the
        sampler to be controlled from another computer or device, which may have
-       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="WHAT_IS_JSAMPLER_DISTRIBUTION"></a>What is a JSampler distribution?</h2></div></div></div><p>A JSampler distribution consist of the JSampler core and at least
        one view, providing the GUI implementation. Each distribution has its
        own name, which is based on the integrated view extension. Currently,
        there are two distributions:</p><div class="itemizedlist"><ul type="disc"><li><p>JS Classic - A distribution with a standard GUI, capable of
              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="SCREENSHOTS"></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="INSTALLATION"></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_JSAMPLER">Running a JSampler distribution</a></span></dt><dt><span class="section"><a href="#USING_SCRIPT">Using a script to run a JSampler distribution</a></span></dt><dt><span class="section"><a href="#GNOME_JAR_ASSOCIATIONS">Telling Gnome how to handle jar files</a></span></dt><dt><span class="section"><a href="#GNOME_LAUNCHER">Adding an application launcher to a Gnome panel</a></span></dt><dt><span class="section"><a href="#RUNING_ON_WINDOWS">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.8a.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.8a.jar" target="_top">Fantasia</a>.</p><p>The source code is available in the <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.8a.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.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
        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 5
+       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_JSAMPLER"></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.4a.jar</code>, which is located in
+       <code class="code">JS_Classic-0.8a.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.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
        issuing the following command:</p><p><span><strong class="command">java -jar
-       /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.8a.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 49 
 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.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.8a.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="USING_SCRIPT"></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.4a.tar.bz2" target="_top">JSampler
+       <a href="http://downloads.sourceforge.net/jsampler/JSampler-0.8a.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="GNOME_JAR_ASSOCIATIONS"></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 63 
 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="GNOME_LAUNCHER"></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_JSAMPLER" 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="RUNING_ON_WINDOWS"></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="id250449"></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="BUILDING_FROM_SOURCE"></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="#BUILDING_FROM_CVS">Building from CVS</a></span></dt><dt><span class="section"><a href="#COMPILATION">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="BUILDING_FROM_CVS"></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 85 
 locate bin/java</strong></span></p></div
+Line 82 
 locate bin/java</strong></span></p></div
        <code class="code">lib/required</code> directory in the JSampler root and copy the
        <code class="code">jlscp.jar</code> and <code class="code">juife.jar</code> files in that
        directory:</p><div class="literallayout"><p><span><strong class="command">cd /home/me/soft<br>
- wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.4a.tar.bz2<br>
+ wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.7a.tar.bz2<br>
- tar -xjf jlscp-0.4a.tar.bz2<br>
+ tar -xjf jlscp-0.7a.tar.bz2<br>
  wget -c http://downloads.sourceforge.net/juife/juife-0.4a.tar.bz2<br>
  tar -xjf juife-0.4a.tar.bz2<br>
  cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler<br>
  cd jsampler<br>
  mkdirhier lib/required<br>
- cp ../jlscp-0.4a/lib/jlscp.jar lib/required/jlscp.jar<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><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>In most cases it is sufficient just to copy the
+         <span><strong class="command">lib</strong></span> directory from the last release, but first
+         check if there are some significant recent changes to those
+         libraries.</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="COMPILATION"></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
 Line 105 
 cp ../juife-0.4a/lib/juife.jar lib/requi
              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></ul></div><p>So, if you want to build a JS Classic distribution, just issue the
        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
-       desired location.</p></div></div></div></body></html>
+       desired location.</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="USING_ORCHESTRAS"></a>Chapter 5. Using Orchestras</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#MANAGING_ORCHESTRAS">Managing Orchestras</a></span></dt><dt><span class="section"><a href="#MANAGING_INSTRUMENTS">Managing Instruments</a></span></dt><dt><span class="section"><a href="#LOADING_ORCHESTRA_INSTRUMENTS">Loading Instruments</a></span></dt></dl></div><p>Orchestras feature is like bookmarks/favorites for instruments.
+     Instead of having a thousands of unsorted instruments you can categorize
+     your most used instruments for quick access by adding them to orchestras.
+     You can create an arbitrary number of orchestras and in any orchestra you
+     can add an arbitrary number of instruments.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Orchestras are not handled by the back-end (LinuxSampler) and
+         does not depend on the <span class="guilabel">Instruments Database</span>. The
+         orchestras are handled by JSampler and are stored on the local machine
+         in <code class="code">&lt;jsampler-home&gt;/orchestras.xml</code>. To port the
+         orchestras to another machine just copy that file.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="MANAGING_ORCHESTRAS"></a>Managing Orchestras</h2></div></div></div><p><span class="guilabel">Manage Orchestras</span> tool buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Create new
+       orchestra</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
+       selected orchestra</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
+       selected orchestra</span></p><p>To create a new orchestra, click on the
+       <span class="guilabel">Orchestras</span> tab then click the <span class="guibutton">Create new
+       orchestra</span> button in the <span class="guilabel">Manage
+       Orchestras</span> tool:</p><div align="center"><img src="images/new-orchestra.png" align="middle"></div><p>Then
+       choose orchestra name and description and click
+       <span class="guibutton">OK</span> button.</p><p>To remove an orchestra, select the orchestra and click the
+       <span class="guibutton">Remove selected orchestra</span> button. To edit an
+       orchestra, select the orchestra and click the <span class="guibutton">Edit selected
+       orchestra</span> button, or just double-click the orchestra to
+       edit.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>To change the position of an orchestra in the orchestra list,
+           select the orchestra and use <span class="guilabel">Alt+Up Arrow</span> and
+           <span class="guilabel">Alt+Down Arrow</span> to move the selected orchestra
+           up/down. You can also use <span class="guilabel">Alt+Shift+Up Arow</span> to
+           move the selected orchestra on top and <span class="guilabel">Alt+Shift+Down
+           Arrow</span> to move the selected orchestra to bottom.</p></div><p></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="MANAGING_INSTRUMENTS"></a>Managing Instruments</h2></div></div></div><p><span class="guilabel">Managing Instruments</span> tool buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Add new
+       instrument</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
+       selected instrument</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
+       selected instrument</span></p><p>To add a new instrument to orchestra, first select the desired
+       orchestra from the combobox then click the <span class="guilabel">Add new
+       instrument</span> button:</p><div align="center"><img src="images/add-instrument-to-orchestra.png" align="middle"></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>The easiest way to add an instrument to orchestra is to
+           right-click an instrument in the <span class="guilabel">Instruments
+           Database</span>, then select <span class="guimenu">Add To Orchestra</span>
+           and choose the orchestra to which to add the selected instrument.
+           Note that you can select and add more than one instrument to
+           orchestra at once.</p></div><p>To remove an instrument, select the instrument and click the
+       <span class="guibutton">Remove selected instrument</span> button. To edit an
+       instrument, select the instrument and click the <span class="guibutton">Edit selected
+       instrument</span> button, or just double-click the instrument to
+       edit.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>To change the position of an instrument in the instrument
+           list, select the instrument and use <span class="guilabel">Alt+Up
+           Arrow</span> and <span class="guilabel">Alt+Down Arrow</span> to move the
+           selected instrument up/down. You can also use <span class="guilabel">Alt+Shift+Up
+           Arow</span> to move the selected instrument on top and
+           <span class="guilabel">Alt+Shift+Down Arrow</span> to move the selected
+           instrument to bottom.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="LOADING_ORCHESTRA_INSTRUMENTS"></a>Loading Instruments</h2></div></div></div><p>To load an instrument from orchestra to a sampler channel,
+       right-click on the instrument, select <span class="guimenu">Load
+       Instrument</span>, then choose on which channel to load the selected
+       instrument. You can also load an instrument from orchestra to a sampler
+       channel using the instrument chooser of the sampler channel - click
+       <span class="guilabel">Select instrument from orchestra</span> radio button,
+       choose orchestra and isntrument from the comboboxes and click
+       <span class="guibutton">OK</span> button</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="MIDI_INSTRUMENTS"></a>Chapter 6. MIDI Instruments</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id2479911">Managing MIDI Instrument Maps</a></span></dt><dt><span class="section"><a href="#id2480012">Managing MIDI Instruments</a></span></dt><dt><span class="section"><a href="#id2480118">Assigning MIDI Instrument Map To Sampler Channel</a></span></dt></dl></div><p>The sole purpose of the MIDI instrument mapping is to provide a way
+     to change the loaded instrument on a specific sampler channel through the
+     MIDI keyboard by switching to different MIDI bank/program. To do that you
+     need at least one MIDI instrument map with MIDI instruments mapped for the
+     desired MIDI banks/programs and to assign that map to the sampler channels
+     which instruments should be switched using MIDI bank/program
+     changes.</p><p>Note that when stopping LinuxSampler all MIDI instrument mappings
+     are gone forever, so it is crucial to export the MIDI instrument maps
+     before quiting your session to be able to load them again next time you
+     start LinuxSampler. This can be done by choosing
+     <span class="guimenu">Actions</span>/<span class="guimenu">Export</span>/<span class="guimenu">MIDI
+     Instrument Maps</span>.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2479911"></a>Managing MIDI Instrument Maps</h2></div></div></div><p><span class="guilabel">MIDI Instrument Maps</span> tool buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Add MIDI
+       instrument map</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
+       selected MIDI instrument map</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
+       selected MIDI instrument map</span></p><p>To create a new MIDI instrument map, click the <span class="guilabel">MIDI
+       Instruments</span> tab in the Left-Side pane then click the
+       <span class="guibutton">Add MIDI instrument map</span> button.</p><div><img src="images/add-midi-map.png"></div><p>Then choose map name and click <span class="guibutton">OK</span>
+       button.</p><p>To remove a map, select the map and click the <span class="guibutton">Remove
+       selected MIDI instrument map</span> button. To edit a map, select
+       the map and click the <span class="guibutton">Edit selected MIDI instrument
+       map</span> button, or just double-click the map to edit.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480012"></a>Managing MIDI Instruments</h2></div></div></div><p><span class="guilabel">Managing MIDI Instruments</span> tool
+       buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Add new
+       MIDI instrument</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
+       selected MIDI instrument</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
+       selected MIDI instrument or bank</span></p><p>To map a MIDI instrument, first select the desired MIDI instrument
+       map from the combobox then click the <span class="guilabel">Add new MIDI
+       instrument</span> button:</p><div align="center"><img src="images/map-midi-instrument.png" align="middle"></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>The <a href="#INSTRUMENTS_DB_ADD_TO_MAP" title="Adding Instruments To MIDI Instrument Map">easiest way to
+           map a MIDI instrument</a> is from the <a href="#INSTRUMENTS_DATABASE" title="Chapter 7. Instruments Database">Instruments Database</a>.</p></div><p>To remove a MIDI bank/instrument, select the MIDI
+       bank/instrument and click the <span class="guibutton">Remove selected MIDI instrument
+       or bank</span> button. To edit a MIDI instrument, select the MIDI
+       instrument and click the <span class="guibutton">Edit selected MIDI
+       instrument</span> button, or just double-click the MIDI instrument
+       to edit.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480118"></a>Assigning MIDI Instrument Map To Sampler Channel</h2></div></div></div><p>To assign MIDI instrument map to specific sampler channel, click
+       the <span class="guibutton">Options</span> button to expand the channel options
+       pane then select the desired map from the <span class="guilabel">MIDI Instrument
+       Map</span> combobox:</p><div><img src="images/assign-midi-map.png"></div></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="INSTRUMENTS_DATABASE"></a>Chapter 7. Instruments Database</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id2480256">Adding Instruments To The Instruments Database</a></span></dt><dt><span class="section"><a href="#id2480326">Manging Instruments And Directories</a></span></dt><dt><span class="section"><a href="#id2480489">Loading Instruments From The Instruments Database</a></span></dt><dt><span class="section"><a href="#INSTRUMENTS_DB_ADD_TO_MAP">Adding Instruments To MIDI Instrument Map</a></span></dt><dt><span class="section"><a href="#id2480561">Adding Instruments To Orchestra From The Instruments
+       Database</a></span></dt><dt><span class="section"><a href="#id2480604">Finding Instruments</a></span></dt></dl></div><p>The communication between LinuxSampler and its front-ends is TCP/IP
+     based, which provides an option the sampler to be controlled from another
+     computer or device, and while instrument loading is a regular task in the
+     sampler, there should also be a convenient way to browse and load
+     instruments (located on the sampler box) from a front-end launched on a
+     remote host. This need is well covered by the <span class="guilabel">Instruments
+     Database</span>. However, this is not the only purpose of the
+     Instruments Database. It is a great tool that helps you to not get lost in
+     your instrument collection, providing you a flexible way to create your
+     own tree structure and to organize your instruments in more than one way,
+     without moving or altering the instrument files located all over your hard
+     drives. Another great feature is the search engine with enhanced search
+     capabilities providing you fast and easy way of finding instruments by
+     various criteria.</p><p>It is crucial to understand that, unlike <a href="#USING_ORCHESTRAS" title="Chapter 5. Using Orchestras">Orchestras</a>, the Instruments Database is
+     handled by LinuxSampler, not by JSampler, and by default the database file
+     is located in <span><strong class="command">/var/lib/linuxsampler/instruments.db</strong></span> on
+     the host where the back-end is started.</p><p>Note that you can have more than one instruments database and you
+     can specify which one to be used on LinuxSampler startup. To create a new
+     database file issue the following command:</p><p><span><strong class="command">linuxsampler --create-instruments-db
+     my_instruments.db</strong></span></p><p>which will create a new database file called
+     <span><strong class="command">my_instruments.db</strong></span> in the current directory.</p><p>To start LinuxSampler using the newly created instruments database
+     use the <span><strong class="command">--instruments-db-location</strong></span> option:</p><p><span><strong class="command">linuxsampler --instruments-db-location
+     my_instruments.db</strong></span></p><p>To backup the instruments database just copy the database
+     file.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480256"></a>Adding Instruments To The Instruments Database</h2></div></div></div><p>Choose <span class="guimenu">Window</span> <span class="guimenuitem">Instruments
+       Database</span> to bring up the Instruments Database window, or
+       click the corresponding tool button. Initialy, the instruments database
+       is empty, so you should manually create the desired directories and add
+       instruments to them.</p><p>To create a new directory, select the directory, in which the new
+       directory should be created and choose
+       <span class="guimenu">Actions</span>/<span class="guimenu">Create Directory</span>, or
+       right-click a blank area and choose <span class="guimenuitem">Create
+       Directory</span>.</p><p>To add instruments to specific instruments database directory, go
+       to that directory and select <span class="guimenu">Actions</span>/<span class="guimenu">Add
+       Instruments</span> submenu, where you have two options - to scan a
+       specific instrument file and add the instruments in that file to the
+       instruments database or scan a file system directory for instrument
+       files and add the instruments to the instruments database.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480326"></a>Manging Instruments And Directories</h2></div></div></div><p>Basic commands:</p><p><span><strong class="command">Cut</strong></span> -
+       <span class="guimenu">Edit</span>/<span class="guimenu">Cut</span>, or right-click on a
+       selected file or directory and choose <span class="guibutton">Cut,</span> or
+       Ctrl+X</p><p><span><strong class="command">Copy</strong></span> -
+       <span class="guimenu">Edit</span>/<span class="guimenu">Copy</span>, or right-click on a
+       selected file or directory and choose <span class="guibutton">Copy,</span> or
+       Ctrl+C</p><p><span><strong class="command">Paste</strong></span> -
+       <span class="guimenu">Edit</span>/<span class="guimenu">Paste</span>, or right-click a blank
+       area and choose <span class="guibutton">Paste,</span> or Ctrl+V</p><p><span><strong class="command">Rename</strong></span> -
+       <span class="guimenu">Edit</span>/<span class="guimenu">Rename</span>, or right-click on a
+       selected file or directory and choose <span class="guibutton">Rename,</span> or
+       press <span><strong class="command">F2</strong></span></p><p><span><strong class="command">Delete</strong></span> -
+       <span class="guimenu">Actions</span>/<span class="guimenu">Delete</span>, or right-click on
+       a selected file or directory and choose <span class="guibutton">Delete,</span>
+       or press the <span><strong class="command">Delete</strong></span> key from the keyboard</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>This commands also work on a multiple selection.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480489"></a>Loading Instruments From The Instruments Database</h2></div></div></div><p>To load an instrument to a sampler channel from the Instruments
+       Database, right-click on the instrument and choose <span class="guimenu">Load
+       Instrument</span>, then choose the sampler channel where the
+       instrument should be loaded to. Note that you need to have at least one
+       sampler channel created, otherwise the <span class="guimenu">Load
+       Instrument</span> submenu is disabled.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="INSTRUMENTS_DB_ADD_TO_MAP"></a>Adding Instruments To MIDI Instrument Map</h2></div></div></div><p>To add an instrument to MIDI instrument map from the Instruments
+       Database, right-click on the instrument and choose <span class="guimenu">Add To MIDI
+       Map</span>, then choose the MIDI instrument map to which to add the
+       selected instrument. Note that you need to have at least one MIDI
+       instrument map, otherwise the <span class="guimenu">Add To MIDI Map</span> submenu
+       is disabled. For more info read <a href="#MIDI_INSTRUMENTS" title="Chapter 6. MIDI Instruments">MIDI
+       Instruments</a>.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>To add more than one instrument from an instrument directory
+           at a time, select the instruments and right-click on one of the
+           selected instruments.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480561"></a>Adding Instruments To Orchestra From The Instruments
+       Database</h2></div></div></div><p>To add an instrument to orchestra from the Instruments Database,
+       right-click on the instrument and choose <span class="guimenu">Add To
+       Orchestra</span>, then choose the orchestra to which to add the
+       selected instrument. Note that you need to have at least one orchestra,
+       otherwise the <span class="guimenu">Add To Orchestra</span> submenu is disabled.
+       For more info read <a href="#USING_ORCHESTRAS" title="Chapter 5. Using Orchestras">Using
+       Orchestras</a>.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>To add more than one instrument from an instrument directory
+           at a time, select the instruments and right-click on one of the
+           selected instruments.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2480604"></a>Finding Instruments</h2></div></div></div><p>To start a search, choose
+       <span class="guimenu">Edit</span>/<span class="guimenu">Find</span>, or Ctrl+F.</p></div></div></div></body></html>

 Legend:



Removed from v.1146
 


changed lines


 
Added in v.1759
 Legend:



Removed from v.1146
 


changed lines


 
Added in v.1759
-Removed from v.1146
+Added in v.1759

	ViewVC Help
Powered by ViewVC