--- web/trunk/www.linuxsampler.org/jsampler/manual/html/jsampler.html 2008/08/26 20:38:24 1757 +++ web/trunk/www.linuxsampler.org/jsampler/manual/html/jsampler.html 2008/08/26 20:43:22 1758 @@ -1,4 +1,5 @@ -JSampler Manual

JSampler Manual

by Grigor Iliev

This document is released under the terms of the GNU Free Documentation License.

Updated: Sat, 8 December 2007


Table of Contents

1. Introduction
What is JSampler?
What is a JSampler distribution?
2. Screenshots
3. Installation
What to download?
Requirements
Running a JSampler distribution
Using a script to run a JSampler distribution
Telling Gnome how to handle jar files
Adding an application launcher to a Gnome panel
Running JSampler on Windows
4. Building from source
Building from CVS
Compilation
5. Using Orchestras
Managing Orchestras
Managing Instruments
Loading Instruments

Chapter 1. Introduction

What is JSampler?

JSampler is an opensource, platform-independent, GUI front-end for +JSampler Manual

JSampler Manual

by Grigor Iliev

This document is released under the terms of the GNU Free Documentation License.

Updated: Tue, 26 August 2008


Chapter 1. Introduction

What is JSampler?

JSampler is an opensource, platform-independent, GUI front-end for LinuxSampler, written entirely in Java. The main goal of the JSampler's design is to be extensible and more flexible regarding @@ -89,7 +90,10 @@ cd jsampler
mkdirhier lib/required
cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar
-cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar

Then follow the steps in the next section.

Compilation

To build a JSampler distribution, first set the +cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar

Tip

In most cases it is sufficient just to copy the + lib directory from the last release, but first + check if there are some significant recent changes to those + libraries.

Then follow the steps in the next section.

Compilation

To build a JSampler distribution, first set the JAVA_HOME 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:

export JAVA_HOME=/opt/jdk1.6.0

Windows users should do something like:

set JAVA_HOME=c:\jdk1.6.0

Go to the JSampler root directory and issue the following @@ -109,7 +113,7 @@ 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 + orchestras to another machine just copy that file.

Managing Orchestras

Manage Orchestras tool buttons:

Create new orchestra

Edit selected orchestra

Remove selected orchestra

To create a new orchestra, click on the @@ -117,7 +121,7 @@ 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 + 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 @@ -126,7 +130,7 @@ 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 + Arrow to move the selected orchestra to bottom.

Managing Instruments

Managing Instruments tool buttons:

Add new instrument

Edit selected instrument

Remove selected instrument

To add a new instrument to orchestra, first select the desired @@ -153,4 +157,113 @@ 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.

+ OK button

Chapter 6. MIDI Instruments

Table of Contents

Managing MIDI Instrument Maps
Managing MIDI Instruments
Assigning MIDI Instrument Map To Sampler Channel

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.

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 + Actions/Export/MIDI + Instrument Maps.

Managing MIDI Instrument Maps

MIDI Instrument Maps tool buttons:

Add MIDI + instrument map

Edit + selected MIDI instrument map

Remove + selected MIDI instrument map

To create a new MIDI instrument map, click the MIDI + Instruments tab in the Left-Side pane then click the + Add MIDI instrument map button.

Then choose map name and click OK + button.

To remove a map, select the map and click the Remove + selected MIDI instrument map button. To edit a map, select + the map and click the Edit selected MIDI instrument + map button, or just double-click the map to edit.

Managing MIDI Instruments

Managing MIDI Instruments tool + buttons:

Add new + MIDI instrument

Edit + selected MIDI instrument

Remove + selected MIDI instrument or bank

To map a MIDI instrument, first select the desired MIDI instrument + map from the combobox then click the Add new MIDI + instrument button:

To remove a MIDI bank/instrument, select the MIDI + bank/instrument and click the Remove selected MIDI instrument + or bank button. To edit a MIDI instrument, select the MIDI + instrument and click the Edit selected MIDI + instrument button, or just double-click the MIDI instrument + to edit.

Assigning MIDI Instrument Map To Sampler Channel

To assign MIDI instrument map to specific sampler channel, click + the Options button to expand the channel options + pane then select the desired map from the MIDI Instrument + Map combobox:

Chapter 7. Instruments Database

Table of Contents

Adding Instruments To The Instruments Database
Manging Instruments And Directories
Loading Instruments From The Instruments Database
Adding Instruments To MIDI Instrument Map
Adding Instruments To Orchestra From The Instruments + Database
Finding Instruments

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 Instruments + Database. 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.

It is crucial to understand that, unlike Orchestras, the Instruments Database is + handled by LinuxSampler, not by JSampler, and by default the database file + is located in /var/lib/linuxsampler/instruments.db on + the host where the back-end is started.

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:

linuxsampler --create-instruments-db + my_instruments.db

which will create a new database file called + my_instruments.db in the current directory.

To start LinuxSampler using the newly created instruments database + use the --instruments-db-location option:

linuxsampler --instruments-db-location + my_instruments.db

To backup the instruments database just copy the database + file.

Adding Instruments To The Instruments Database

Choose Window Instruments + Database 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.

To create a new directory, select the directory, in which the new + directory should be created and choose + Actions/Create Directory, or + right-click a blank area and choose Create + Directory.

To add instruments to specific instruments database directory, go + to that directory and select Actions/Add + Instruments 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.

Manging Instruments And Directories

Basic commands:

Cut - + Edit/Cut, or right-click on a + selected file or directory and choose Cut, or + Ctrl+X

Copy - + Edit/Copy, or right-click on a + selected file or directory and choose Copy, or + Ctrl+C

Paste - + Edit/Paste, or right-click a blank + area and choose Paste, or Ctrl+V

Rename - + Edit/Rename, or right-click on a + selected file or directory and choose Rename, or + press F2

Delete - + Actions/Delete, or right-click on + a selected file or directory and choose Delete, + or press the Delete key from the keyboard

Tip

This commands also work on a multiple selection.

Loading Instruments From The Instruments Database

To load an instrument to a sampler channel from the Instruments + Database, right-click on the instrument and choose Load + Instrument, 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 Load + Instrument submenu is disabled.

Adding Instruments To MIDI Instrument Map

To add an instrument to MIDI instrument map from the Instruments + Database, right-click on the instrument and choose Add To MIDI + Map, 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 Add To MIDI Map submenu + is disabled. For more info read MIDI + Instruments.

Tip

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.

Adding Instruments To Orchestra From The Instruments + Database

To add an instrument to orchestra from the Instruments Database, + right-click on the instrument and choose Add To + Orchestra, then choose the orchestra to which to add the + selected instrument. Note that you need to have at least one orchestra, + otherwise the Add To Orchestra submenu is disabled. + For more info read Using + Orchestras.

Tip

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.

Finding Instruments

To start a search, choose + Edit/Find, or Ctrl+F.