1 |
|
2 |
JSampler - A java front-end for LinuxSampler |
3 |
|
4 |
by Grigor Iliev <grigor@grigoriliev.com> |
5 |
|
6 |
|
7 |
The Latest Version |
8 |
================== |
9 |
|
10 |
The latest version can be downloaded from |
11 |
http://sourceforge.net/projects/jsampler/ |
12 |
|
13 |
See also: http://www.linuxsampler.org/downloads.html |
14 |
|
15 |
|
16 |
License |
17 |
======= |
18 |
|
19 |
This software is licensed under the terms of |
20 |
the GNU General Public License Version 2 (see COPYING file). |
21 |
|
22 |
|
23 |
Requirements |
24 |
============ |
25 |
|
26 |
To run JSampler you need Java Runtime Environment (JRE) version 6 or higher. |
27 |
|
28 |
To build a distribution you need JDK version 6.0 or higher |
29 |
and the Ant tool (http://ant.apache.org/). |
30 |
|
31 |
|
32 |
Distributions |
33 |
============= |
34 |
|
35 |
All available distributions are located in the dist directory. |
36 |
|
37 |
|
38 |
Compilation |
39 |
=========== |
40 |
|
41 |
To build a JSampler distribution follow the next steps. |
42 |
(there are two distribution available for now - JS Classic and Fantasia) |
43 |
|
44 |
1. Set the JAVA_HOME environment variable to point to your JDK directory. |
45 |
If the JDK is installed in /opt/jdk1.6.0 directory, this can be done |
46 |
by issuing the following command: |
47 |
|
48 |
export JAVA_HOME=/opt/jdk1.6.0 |
49 |
|
50 |
(Windows users should do something like `set JAVA_HOME=c:\jdk1.6.0') |
51 |
|
52 |
2. Choose one or more of the following options. |
53 |
|
54 |
- Building a JS Classic distribution: `ant build-jsclassic' |
55 |
|
56 |
- Cleaning the JS Classic distribution: `ant clean-jsclassic' |
57 |
|
58 |
- Building a Fantasia distribution: `ant build-fantasia' |
59 |
|
60 |
- Cleaning the Fantasia distribution: `ant clean-fantasia' |
61 |
|
62 |
|
63 |
Installation |
64 |
============ |
65 |
|
66 |
Copy the desired file (dist/JS_Classic-0.6a.jar or dist/Fantasia-0.6a.jar) |
67 |
to some location. That's it! |
68 |
|
69 |
You may also consider using a script for running particular distribution. |
70 |
Look at scripts directory to find an appropriate script for that. |
71 |
|
72 |
|
73 |
Running |
74 |
======= |
75 |
|
76 |
On some systems double clicking on the jar file will be enough. |
77 |
If you aren't that lucky use the following |
78 |
commands to run JS Classic or Fantasia: |
79 |
|
80 |
java -jar /<path-to-js-classic>/JS_Classic-0.7a.jar |
81 |
java -jar /<path-to-fantasia>/Fantasia-0.7a.jar |
82 |
|
83 |
If the java command is not in your path, locate your jre directory and type: |
84 |
|
85 |
/<jre-dir>/bin/java -jar /<path-to-js-classic>/JS_Classic-0.7a.jar |
86 |
/<jre-dir>/bin/java -jar /<path-to-fantasia>/Fantasia-0.7a.jar |
87 |
|
88 |
Note that you must run LinuxSampler before running a JSampler frontend. |
89 |
|
90 |
Libraries Used |
91 |
============== |
92 |
The following libraries are used in the JSampler core: |
93 |
* Library: jlscp |
94 |
License: GNU General Public License Version 2 |
95 |
Website: http://sourceforge.net/projects/jlscp/ |
96 |
|
97 |
* Library: juife |
98 |
License: GNU Lesser General Public License (LGPL) |
99 |
Website: http://sourceforge.net/projects/juife/ |
100 |
|
101 |
The following libraries are used in the Fantasia distribution: |
102 |
* Library: substance |
103 |
License: Berkeley Software Distribution (BSD) |
104 |
Website: http://substance.dev.java.net |
105 |
|
106 |
* Library: swingx |
107 |
License: GNU Lesser General Public License (LGPL) |
108 |
Website: http://swingx.dev.java.net |
109 |
|
110 |
* Library: substance-swingx |
111 |
License: GNU Lesser General Public License (LGPL) |
112 |
Website: http://substance-swingx.dev.java.net |
113 |
|
114 |
|
115 |
Credits |
116 |
======= |
117 |
|
118 |
Special thanks to Olivier Boyer - the creator |
119 |
of the initial graphic design of Fantasia. |
120 |
|
121 |
|
122 |
For more information read the manual, which is located at `manual' directory. |
123 |
Thanks for using JSampler. |
124 |
|