1 |
|
2 |
jlscp - A java LinuxSampler control protocol API |
3 |
|
4 |
by Grigor Iliev <gr.iliev@gmail.com> |
5 |
|
6 |
|
7 |
This library provides client API for retrieving information and |
8 |
configuring running LinuxSampler instance according to the LinuxSampler |
9 |
control protocol as specified in the LSCP protocol specification |
10 |
(http://www.linuxsampler.org/api/draft-linuxsampler-protocol.html) |
11 |
written by Christian Schoenebeck. |
12 |
|
13 |
For more information about LinuxSampler visit http://www.linuxsampler.org |
14 |
|
15 |
|
16 |
Requirements |
17 |
------------ |
18 |
|
19 |
To use jlscp you need java version 1.5.0 or higher. |
20 |
|
21 |
|
22 |
Compilation |
23 |
----------- |
24 |
|
25 |
To compile the library and place the generated class files in the |
26 |
lib directory, cd to src directory and use the following command: |
27 |
|
28 |
javac org/linuxsampler/lscp/*.java org/linuxsampler/lscp/event/*.java -d ../lib |
29 |
|
30 |
To create the JAR file, cd to lib directory and use the following command: |
31 |
|
32 |
jar -cf jlscp.jar org |
33 |
|
34 |
|
35 |
Installation |
36 |
------------ |
37 |
|
38 |
To install jlscp as an extension just copy jlscp.jar in the following directory: |
39 |
|
40 |
<JDK-home>/jre/lib/ext |
41 |
|
42 |
If you don't want to install jlscp as an extension, you may use the following |
43 |
option when compiling or running an application that depends on it: |
44 |
|
45 |
-cp .:/path/to/jlscp/jlscp.jar |
46 |
|
47 |
|
48 |
Documentation |
49 |
------------- |
50 |
|
51 |
The documentation is located in the doc directory. Also you can look at the |
52 |
examples directory. |
53 |
|
54 |
|
55 |
Running examples |
56 |
---------------- |
57 |
|
58 |
To run the examples cd to examples directory |
59 |
and use one of the following commands: |
60 |
|
61 |
java -cp /path/to/jlscp/jlscp.jar:. Poll |
62 |
java -cp /path/to/jlscp/jlscp.jar:. Events |
63 |
java -cp /path/to/jlscp/jlscp.jar:. CreateChannel |
64 |
|
65 |
Notice that on Windows platforms class path entries are separated by |
66 |
semicolons (;) instead of colons (:). |
67 |
|