--- jsampler/trunk/manual/docbook/jsampler.xml 2007/12/08 12:28:53 1582 +++ jsampler/trunk/manual/docbook/jsampler.xml 2007/12/08 13:13:20 1583 @@ -22,13 +22,13 @@ url="gfdl.html">GNU Free Documentation License. - Updated: Fri, 10 August 2007 + Updated: Sat, 8 December 2007 - + Introduction -
+
What is JSampler? JSampler is an opensource, platform-independent, GUI front-end for @@ -57,7 +57,7 @@ different display requirements and limitations.
-
+
What is a JSampler distribution? A JSampler distribution consist of the JSampler core and at least @@ -82,7 +82,7 @@
- + Screenshots JS Classic with left pane, LS console, statusbar and toolbars @@ -102,22 +102,22 @@ fileref="images/fantasia-preview.png" /> - + Installation -
+
What to download? Currently, there are two distributions available for download - JS + url="http://downloads.sourceforge.net/jsampler/JS_Classic-0.8a.jar">JS Classic and Fantasia. + url="http://downloads.sourceforge.net/jsampler/Fantasia-0.8a.jar">Fantasia. The source code is available in the JSampler + url="http://downloads.sourceforge.net/jsampler/JSampler-0.8a.tar.bz2">JSampler package, which also contains this manual and startup scripts that can be used to run a particular JSampler distribution. @@ -129,7 +129,7 @@ jsampler
-
+
Requirements To run JSampler you need Java Runtime Environment (JRE) version 6 @@ -141,11 +141,11 @@ tool.
-
+
Running a JSampler distribution Let's assume that you want to run from the command line - JS_Classic-0.6a.jar, which is located in + JS_Classic-0.8a.jar, which is located in /home/me/soft directory. First you should check whether the java command is in your path and the version requirements are met. This can be done by issuing the following command: @@ -156,7 +156,7 @@ issuing the following command: java -jar - /home/me/soft/JS_Classic-0.6a.jar + /home/me/soft/JS_Classic-0.8a.jar Otherwise, if the shell response is something like @@ -184,7 +184,7 @@ Classic issue the following command: /opt/jdk1.6.0/bin/java -jar - /home/me/soft/JS_Classic-0.6a.jar + /home/me/soft/JS_Classic-0.8a.jar On some systems double clicking on the jar file will be @@ -192,18 +192,18 @@
-
+
Using a script to run a JSampler distribution There are scripts In the scripts directory of the JSampler + url="http://downloads.sourceforge.net/jsampler/JSampler-0.8a.tar.bz2">JSampler package 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.
-
+
Telling Gnome how to handle jar files This configuration is optional, but necessary if you want to run @@ -228,7 +228,7 @@
-
+
Adding an application launcher to a Gnome panel To add an application launcher to a Gnome panel, right click on @@ -241,14 +241,14 @@ Command field, of the Create Launcher 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 click - here. + distribution from the command line click here.
-
+
Running JSampler on Windows To run JSampler distribution on Windows, put a shortcut on the @@ -260,14 +260,14 @@
- + Building from source If you want to build a JSampler distribution from source, first make - sure that all requirements are + sure that all requirements are met. -
+
Building from CVS When building from CVS, there are some additional steps that @@ -292,8 +292,8 @@ directory: cd /home/me/soft -wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.5a.tar.bz2 -tar -xjf jlscp-0.5a.tar.bz2 +wget -c http://downloads.sourceforge.net/jlscp/jlscp-0.7a.tar.bz2 +tar -xjf jlscp-0.7a.tar.bz2 wget -c http://downloads.sourceforge.net/juife/juife-0.4a.tar.bz2 tar -xjf juife-0.4a.tar.bz2 cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler @@ -305,7 +305,7 @@ Then follow the steps in the next section.
-
+
Compilation To build a JSampler distribution, first set the @@ -367,4 +367,113 @@ desired location.
+ + + Using Orchestras + + 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. + Orchestras are not handled by the back-end (LinuxSampler) and + does not depend on the Instruments Database. The + orchestras are handled by JSampler and are stored on the local machine + in <jsampler-home>/orchestras.xml. To port the + orchestras to another machine just copy that file. + + +
+ Managing Orchestras + + Tool buttons: + + Create new + orchestra + + Edit + selected orchestra + + Remove + selected orchestra + + To create a new orchestra, click on the + Orchestras tab then click the Create new + orchestra button in the Manage + Orchestras tool: + + Then + choose orchestra name and description and click + OK button. + + To remove an orchestra, select the orchestra and click the + Remove selected orchestra button. To edit an + orchestra, select the orchestra and click the Edit selected + orchestra button, or just double-click the orchestra to + edit. + To change the position of an orchestra in the orchestra list, + select the orchestra and use Alt+Up Arrow and + Alt+Down Arrow to move the selected orchestra + up/down. You can also use Alt+Shift+Up Arow to + move the selected orchestra on top and Alt+Shift+Down + Arrow to move the selected orchestra to bottom. + + + +
+ +
+ Managing Instruments + + Tool buttons: + + Add new + instrument + + Edit + selected instrument + + Remove + selected instrument + + To add a new instrument to orchestra, first select the desired + orchestra from the combobox then click the Add new + instrument button: + + + The easiest way to add an instrument to orchestra is to + right-click an instrument in the Instruments + Database, then select Add To Orchestra + 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. + To remove an instrument, select the instrument and click the + Remove selected instrument button. To edit an + instrument, select the instrument and click the Edit selected + instrument button, or just double-click the instrument to + edit. + To change the position of an instrument in the instrument + list, select the instrument and use Alt+Up + Arrow and Alt+Down Arrow to move the + selected instrument up/down. You can also use Alt+Shift+Up + Arow to move the selected instrument on top and + Alt+Shift+Down Arrow to move the selected + instrument to bottom. + +
+ +
+ Loading Instruments + + To load an instrument from orchestra to a sampler channel, + right-click on the instrument, select Load + Instrument, 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 + Select instrument from orchestra radio button, + choose orchestra and isntrument from the comboboxes and click + OK button. +
+ \ No newline at end of file