1 |
iliev |
596 |
|
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 |
|
|
|