/[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 1584 by iliev, Sat Dec 8 13:29:47 2007 UTC revision 1758 by iliev, Tue Aug 26 20:43:22 2008 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.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: Sat, 8 December 2007</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></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  <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="id212764"></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="id295081"></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: 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="#id305250">6. MIDI Instruments</a></span></dt><dd><dl><dt><span class="section"><a href="#id305290">Managing MIDI Instrument Maps</a></span></dt><dt><span class="section"><a href="#id305376">Managing MIDI Instruments</a></span></dt><dt><span class="section"><a href="#id305467">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="#id305578">Adding Instruments To The Instruments Database</a></span></dt><dt><span class="section"><a href="#id305636">Manging Instruments And Directories</a></span></dt><dt><span class="section"><a href="#id305780">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="#id305839">Adding Instruments To Orchestra From The Instruments
2          Database</a></span></dt><dt><span class="section"><a href="#id305874">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
3        <a class="ulink" href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written        <a class="ulink" href="http://www.linuxsampler.org" target="_top">LinuxSampler</a>, written
4        entirely in <a class="ulink" 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
5        of the JSampler's design is to be extensible and more flexible regarding        of the JSampler's design is to be extensible and more flexible regarding
# Line 89  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="COMPILATION"></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
94            <span class="command"><strong>lib</strong></span> directory from the last release, but first
95            check if there are some significant recent changes to those
96            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
97        <code class="code">JAVA_HOME</code> environment variable to point to your JDK        <code class="code">JAVA_HOME</code> environment variable to point to your JDK
98        directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can        directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can
99        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        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
# Line 109  cp ../juife-0.4a/lib/juife.jar lib/requi Line 113  cp ../juife-0.4a/lib/juife.jar lib/requi
113          does not depend on the <span class="guilabel">Instruments Database</span>. The          does not depend on the <span class="guilabel">Instruments Database</span>. The
114          orchestras are handled by JSampler and are stored on the local machine          orchestras are handled by JSampler and are stored on the local machine
115          in <code class="code">&lt;jsampler-home&gt;/orchestras.xml</code>. To port the          in <code class="code">&lt;jsampler-home&gt;/orchestras.xml</code>. To port the
116          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>Tool buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Create new          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
117        orchestra</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit        orchestra</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
118        selected orchestra</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove        selected orchestra</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
119        selected orchestra</span></p><p>To create a new orchestra, click on the        selected orchestra</span></p><p>To create a new orchestra, click on the
# Line 117  cp ../juife-0.4a/lib/juife.jar lib/requi Line 121  cp ../juife-0.4a/lib/juife.jar lib/requi
121        orchestra</span> button in the <span class="guilabel">Manage        orchestra</span> button in the <span class="guilabel">Manage
122        Orchestras</span> tool:</p><div align="center"><img src="images/new-orchestra.png" align="middle"></div><p>Then        Orchestras</span> tool:</p><div align="center"><img src="images/new-orchestra.png" align="middle"></div><p>Then
123        choose orchestra name and description and click        choose orchestra name and description and click
124        <span class="guibutton">OK</span> button. </p><p>To remove an orchestra, select the orchestra and click the        <span class="guibutton">OK</span> button.</p><p>To remove an orchestra, select the orchestra and click the
125        <span class="guibutton">Remove selected orchestra</span> button. To edit an        <span class="guibutton">Remove selected orchestra</span> button. To edit an
126        orchestra, select the orchestra and click the <span class="guibutton">Edit selected        orchestra, select the orchestra and click the <span class="guibutton">Edit selected
127        orchestra</span> button, or just double-click the orchestra to        orchestra</span> button, or just double-click the orchestra to
# Line 126  cp ../juife-0.4a/lib/juife.jar lib/requi Line 130  cp ../juife-0.4a/lib/juife.jar lib/requi
130            <span class="guilabel">Alt+Down Arrow</span> to move the selected orchestra            <span class="guilabel">Alt+Down Arrow</span> to move the selected orchestra
131            up/down. You can also use <span class="guilabel">Alt+Shift+Up Arow</span> to            up/down. You can also use <span class="guilabel">Alt+Shift+Up Arow</span> to
132            move the selected orchestra on top and <span class="guilabel">Alt+Shift+Down            move the selected orchestra on top and <span class="guilabel">Alt+Shift+Down
133            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>Tool buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Add new            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
134        instrument</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit        instrument</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
135        selected instrument</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove        selected instrument</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
136        selected instrument</span></p><p>To add a new instrument to orchestra, first select the desired        selected instrument</span></p><p>To add a new instrument to orchestra, first select the desired
# Line 153  cp ../juife-0.4a/lib/juife.jar lib/requi Line 157  cp ../juife-0.4a/lib/juife.jar lib/requi
157        channel using the instrument chooser of the sampler channel - click        channel using the instrument chooser of the sampler channel - click
158        <span class="guilabel">Select instrument from orchestra</span> radio button,        <span class="guilabel">Select instrument from orchestra</span> radio button,
159        choose orchestra and isntrument from the comboboxes and click        choose orchestra and isntrument from the comboboxes and click
160        <span class="guibutton">OK</span> button.</p></div></div></div></body></html>        <span class="guibutton">OK</span> button</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id305250"></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="#id305290">Managing MIDI Instrument Maps</a></span></dt><dt><span class="section"><a href="#id305376">Managing MIDI Instruments</a></span></dt><dt><span class="section"><a href="#id305467">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
161        to change the loaded instrument on a specific sampler channel through the
162        MIDI keyboard by switching to different MIDI bank/program. To do that you
163        need at least one MIDI instrument map with MIDI instruments mapped for the
164        desired MIDI banks/programs and to assign that map to the sampler channels
165        which instruments should be switched using MIDI bank/program
166        changes.</p><p>Note that when stopping LinuxSampler all MIDI instrument mappings
167        are gone forever, so it is crucial to export the MIDI instrument maps
168        before quiting your session to be able to load them again next time you
169        start LinuxSampler. This can be done by choosing
170        <span class="guimenu">Actions</span>/<span class="guimenu">Export</span>/<span class="guimenu">MIDI
171        Instrument Maps</span>.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id305290"></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
172          instrument map</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
173          selected MIDI instrument map</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
174          selected MIDI instrument map</span></p><p>To create a new MIDI instrument map, click the <span class="guilabel">MIDI
175          Instruments</span> tab in the Left-Side pane then click the
176          <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>
177          button.</p><p>To remove a map, select the map and click the <span class="guibutton">Remove
178          selected MIDI instrument map</span> button. To edit a map, select
179          the map and click the <span class="guibutton">Edit selected MIDI instrument
180          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="id305376"></a>Managing MIDI Instruments</h2></div></div></div><p><span class="guilabel">Managing MIDI Instruments</span> tool
181          buttons:</p><p><img src="images/new16.png"> <span class="guilabel">Add new
182          MIDI instrument</span></p><p><img src="images/edit16.png"> <span class="guilabel">Edit
183          selected MIDI instrument</span></p><p><img src="images/delete16.png"> <span class="guilabel">Remove
184          selected MIDI instrument or bank</span></p><p>To map a MIDI instrument, first select the desired MIDI instrument
185          map from the combobox then click the <span class="guilabel">Add new MIDI
186          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 class="link" href="#INSTRUMENTS_DB_ADD_TO_MAP" title="Adding Instruments To MIDI Instrument Map">easiest way to
187              map a MIDI instrument</a> is from the <a class="link" href="#INSTRUMENTS_DATABASE" title="Chapter 7. Instruments Database">Instruments Database</a>.</p></div><p>To remove a MIDI bank/instrument, select the MIDI
188          bank/instrument and click the <span class="guibutton">Remove selected MIDI instrument
189          or bank</span> button. To edit a MIDI instrument, select the MIDI
190          instrument and click the <span class="guibutton">Edit selected MIDI
191          instrument</span> button, or just double-click the MIDI instrument
192          to edit.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id305467"></a>Assigning MIDI Instrument Map To Sampler Channel</h2></div></div></div><p>To assign MIDI instrument map to specific sampler channel, click
193          the <span class="guibutton">Options</span> button to expand the channel options
194          pane then select the desired map from the <span class="guilabel">MIDI Instrument
195          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="#id305578">Adding Instruments To The Instruments Database</a></span></dt><dt><span class="section"><a href="#id305636">Manging Instruments And Directories</a></span></dt><dt><span class="section"><a href="#id305780">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="#id305839">Adding Instruments To Orchestra From The Instruments
196          Database</a></span></dt><dt><span class="section"><a href="#id305874">Finding Instruments</a></span></dt></dl></div><p>The communication between LinuxSampler and its front-ends is TCP/IP
197        based, which provides an option the sampler to be controlled from another
198        computer or device, and while instrument loading is a regular task in the
199        sampler, there should also be a convenient way to browse and load
200        instruments (located on the sampler box) from a front-end launched on a
201        remote host. This need is well covered by the <span class="guilabel">Instruments
202        Database</span>. However, this is not the only purpose of the
203        Instruments Database. It is a great tool that helps you to not get lost in
204        your instrument collection, providing you a flexible way to create your
205        own tree structure and to organize your instruments in more than one way,
206        without moving or altering the instrument files located all over your hard
207        drives. Another great feature is the search engine with enhanced search
208        capabilities providing you fast and easy way of finding instruments by
209        various criteria.</p><p>It is crucial to understand that, unlike <a class="link" href="#USING_ORCHESTRAS" title="Chapter 5. Using Orchestras">Orchestras</a>, the Instruments Database is
210        handled by LinuxSampler, not by JSampler, and by default the database file
211        is located in <span class="command"><strong>/var/lib/linuxsampler/instruments.db</strong></span> on
212        the host where the back-end is started.</p><p>Note that you can have more than one instruments database and you
213        can specify which one to be used on LinuxSampler startup. To create a new
214        database file issue the following command:</p><p><span class="command"><strong>linuxsampler --create-instruments-db
215        my_instruments.db</strong></span></p><p>which will create a new database file called
216        <span class="command"><strong>my_instruments.db</strong></span> in the current directory.</p><p>To start LinuxSampler using the newly created instruments database
217        use the <span class="command"><strong>--instruments-db-location</strong></span> option:</p><p><span class="command"><strong>linuxsampler --instruments-db-location
218        my_instruments.db</strong></span></p><p>To backup the instruments database just copy the database
219        file.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id305578"></a>Adding Instruments To The Instruments Database</h2></div></div></div><p>Choose <span class="guimenu">Window</span> <span class="guimenuitem">Instruments
220          Database</span> to bring up the Instruments Database window, or
221          click the corresponding tool button. Initialy, the instruments database
222          is empty, so you should manually create the desired directories and add
223          instruments to them.</p><p>To create a new directory, select the directory, in which the new
224          directory should be created and choose
225          <span class="guimenu">Actions</span>/<span class="guimenu">Create Directory</span>, or
226          right-click a blank area and choose <span class="guimenuitem">Create
227          Directory</span>.</p><p>To add instruments to specific instruments database directory, go
228          to that directory and select <span class="guimenu">Actions</span>/<span class="guimenu">Add
229          Instruments</span> submenu, where you have two options - to scan a
230          specific instrument file and add the instruments in that file to the
231          instruments database or scan a file system directory for instrument
232          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="id305636"></a>Manging Instruments And Directories</h2></div></div></div><p>Basic commands:</p><p><span class="command"><strong>Cut</strong></span> -
233          <span class="guimenu">Edit</span>/<span class="guimenu">Cut</span>, or right-click on a
234          selected file or directory and choose <span class="guibutton">Cut,</span> or
235          Ctrl+X</p><p><span class="command"><strong>Copy</strong></span> -
236          <span class="guimenu">Edit</span>/<span class="guimenu">Copy</span>, or right-click on a
237          selected file or directory and choose <span class="guibutton">Copy,</span> or
238          Ctrl+C</p><p><span class="command"><strong>Paste</strong></span> -
239          <span class="guimenu">Edit</span>/<span class="guimenu">Paste</span>, or right-click a blank
240          area and choose <span class="guibutton">Paste,</span> or Ctrl+V</p><p><span class="command"><strong>Rename</strong></span> -
241          <span class="guimenu">Edit</span>/<span class="guimenu">Rename</span>, or right-click on a
242          selected file or directory and choose <span class="guibutton">Rename,</span> or
243          press <span class="command"><strong>F2</strong></span></p><p><span class="command"><strong>Delete</strong></span> -
244          <span class="guimenu">Actions</span>/<span class="guimenu">Delete</span>, or right-click on
245          a selected file or directory and choose <span class="guibutton">Delete,</span>
246          or press the <span class="command"><strong>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="id305780"></a>Loading Instruments From The Instruments Database</h2></div></div></div><p>To load an instrument to a sampler channel from the Instruments
247          Database, right-click on the instrument and choose <span class="guimenu">Load
248          Instrument</span>, then choose the sampler channel where the
249          instrument should be loaded to. Note that you need to have at least one
250          sampler channel created, otherwise the <span class="guimenu">Load
251          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
252          Database, right-click on the instrument and choose <span class="guimenu">Add To MIDI
253          Map</span>, then choose the MIDI instrument map to which to add the
254          selected instrument. Note that you need to have at least one MIDI
255          instrument map, otherwise the <span class="guimenu">Add To MIDI Map</span> submenu
256          is disabled. For more info read <a class="link" href="#MIDI_INSTRUMENTS">MIDI
257          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
258              at a time, select the instruments and right-click on one of the
259              selected instruments.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id305839"></a>Adding Instruments To Orchestra From The Instruments
260          Database</h2></div></div></div><p>To add an instrument to orchestra from the Instruments Database,
261          right-click on the instrument and choose <span class="guimenu">Add To
262          Orchestra</span>, then choose the orchestra to which to add the
263          selected instrument. Note that you need to have at least one orchestra,
264          otherwise the <span class="guimenu">Add To Orchestra</span> submenu is disabled.
265          For more info read <a class="link" href="#USING_ORCHESTRAS" title="Chapter 5. Using Orchestras">Using
266          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
267              at a time, select the instruments and right-click on one of the
268              selected instruments.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id305874"></a>Finding Instruments</h2></div></div></div><p>To start a search, choose
269          <span class="guimenu">Edit</span>/<span class="guimenu">Find</span>, or Ctrl+F.</p></div></div></div></body></html>

Legend:
Removed from v.1584  
changed lines
  Added in v.1758

  ViewVC Help
Powered by ViewVC