/[svn]/web/trunk/www.linuxsampler.org/faq.html
ViewVC logotype

Annotation of /web/trunk/www.linuxsampler.org/faq.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1938 - (hide annotations) (download) (as text)
Mon Jul 13 00:35:50 2009 UTC (14 years, 9 months ago) by senoner
File MIME type: text/html
File size: 26432 byte(s)
Added Donation page and sidebar links

1 senoner 542 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2     <html>
3     <head>
4     <link rel="stylesheet" type="text/css" href="index.css">
5     <title>The Linux Sampler Project</title>
6    
7     <meta http-equiv="content-type"
8     content="text/html; charset=ISO-8859-1">
9    
10     <script language="javascript" type="text/javascript">
11     <!--
12     var dir = "gfx/";
13    
14     if(document.images) {
15    
16     newsover = new Image();
17     newsover.src = dir + "mnewshover.png";
18    
19     newsout = new Image();
20     newsout.src = dir + "mnews.png";
21    
22     aboutover = new Image();
23     aboutover.src = dir + "mabouthover.png";
24    
25     aboutout = new Image();
26     aboutout.src = dir + "mabout.png";
27    
28     featuresover = new Image();
29     featuresover.src = dir + "mfeatureshover.png";
30    
31     featuresout = new Image();
32     featuresout.src = dir + "mfeatures.png";
33    
34     screenshotsover = new Image();
35     screenshotsover.src = dir + "mscreenshotshover.png";
36    
37     screenshotsout = new Image();
38     screenshotsout.src = dir + "mscreenshots.png";
39    
40     demosover = new Image();
41     demosover.src = dir + "mdemoshover.png";
42    
43     demosout = new Image();
44     demosout.src = dir + "mdemos.png";
45    
46     downloadsover = new Image();
47     downloadsover.src = dir + "mdownloadshover.png";
48    
49     downloadsout = new Image();
50     downloadsout.src = dir + "mdownloads.png";
51    
52 senoner 1938 donationsover = new Image();
53     donationsover.src = dir + "mdonationshover.png";
54    
55     donationsout = new Image();
56     donationsout.src = dir + "mdonations.png";
57    
58 schoenebeck 1675 supportover = new Image();
59     supportover.src = dir + "msupporthover.png";
60     supportout = new Image();
61     supportout.src = dir + "msupport.png";
62    
63 senoner 542 developersover = new Image();
64     developersover.src = dir + "mdevelopershover.png";
65    
66     developersout = new Image();
67     developersout.src = dir + "mdevelopers.png";
68    
69     instrumentsover = new Image();
70     instrumentsover.src = dir + "minstrumentshover.png";
71    
72     instrumentsout = new Image();
73     instrumentsout.src = dir + "minstruments.png";
74    
75     linksover = new Image();
76     linksover.src = dir + "mlinkshover.png";
77    
78     linksout = new Image();
79     linksout.src = dir + "mlinks.png";
80    
81     documentationover = new Image();
82     documentationover.src = dir + "mdocumentationhover.png";
83    
84     documentationout = new Image();
85     documentationout.src = dir + "mdocumentation.png";
86    
87     creditsover = new Image();
88     creditsover.src = dir + "mcreditshover.png";
89    
90     creditsout = new Image();
91     creditsout.src = dir + "mcredits.png";
92    
93     faqover = new Image();
94     faqover.src = dir + "mfaqhover.png";
95    
96     faqout = new Image();
97     faqout.src = dir + "mfaq.png";
98    
99     bugsover = new Image();
100     bugsover.src = dir + "mbugshover.png";
101    
102     bugsout = new Image();
103     bugsout.src = dir + "mbugs.png";
104     }
105     -->
106     </script>
107    
108     </head>
109    
110     <body>
111    
112     <div id="mainwindow"><img name="LinuxSampler" src="gfx/lsbackground.jpg" alt="LinuxSampler">
113    
114     <h1><span class="hidden">The LinuxSampler Project</span></h1>
115    
116     <table border=0 cellspacing=0 cellpadding=0><tr><th colspan=2 align=left>
117     <img name="h1blank" src="gfx/h1blank.png" alt="blank"><span class="hidden">about</span></th></tr>
118     <tr><td valign=top>
119     <a id="news" href="index.php" onmouseover="javascript:if(document.images)document.news.src = newsover.src" onmouseout="javascript:if(document.images)document.news.src = newsout.src"><img name="news" src="gfx/mnews.png" alt="news"></a>
120     <a id="about" href="about.html" onmouseover="javascript:if(document.images)document.about.src = aboutover.src" onmouseout="javascript:if(document.images)document.about.src = aboutout.src"><img name="about" src="gfx/mabout.png" alt="about"></a>
121     <a id="features" href="features.html" onmouseover="javascript:if(document.images)document.features.src = featuresover.src" onmouseout="javascript:if(document.images)document.features.src = featuresout.src"><img name="features" src="gfx/mfeatures.png" alt="features"></a>
122     <a id="screenshots" href="screenshots.html" onmouseover="javascript:if(document.images)document.screenshots.src = screenshotsover.src" onmouseout="javascript:if(document.images)document.screenshots.src = screenshotsout.src"><img name="screenshots" src="gfx/mscreenshots.png" alt="screenshots"></a>
123     <a id="demos" href="demos.html" onmouseover="javascript:if(document.images)document.demos.src = demosover.src" onmouseout="javascript:if(document.images)document.demos.src = demosout.src"><img name="demos" src="gfx/mdemos.png" alt="demos"></a>
124     <a id="downloads" href="downloads.html" onmouseover="javascript:if(document.images)document.downloads.src = downloadsover.src" onmouseout="javascript:if(document.images)document.downloads.src = downloadsout.src"><img name="downloads" src="gfx/mdownloads.png" alt="download"></a>
125 senoner 1938 <a id="donations" href="donations.html" onmouseover="javascript:if(document.images)document.donations.src = donationsover.src" onmouseout="javascript:if(document.images)document.donations.src = donationsout.src"><img name="donations" src="gfx/mdonations.png" alt="donations"></a>
126 schoenebeck 1675 <a id="support" href="support.html" onmouseover="javascript:if(document.images)document.support.src = supportover.src" onmouseout="javascript:if(document.images)document.support.src = supportout.src"><img name="support" src="gfx/msupport.png" alt="support"></a>
127 senoner 542 <a id="developers" href="developers.html" onmouseover="javascript:if(document.images)document.developers.src = developersover.src" onmouseout="javascript:if(document.images)document.developers.src = developersout.src"><img name="developers" src="gfx/mdevelopers.png" alt="developers"></a>
128     <a id="faq" href="faq.html" onmouseover="javascript:if(document.images)document.faq.src = faqover.src" onmouseout="javascript:if(document.images)document.faq.src = faqout.src"><img name="faq" src="gfx/mfaq.png" alt="faq"></a>
129     <a id="documentation" href="documentation.html" onmouseover="javascript:if(document.images)document.documentation.src = documentationover.src" onmouseout="javascript:if(document.images)document.documentation.src = documentationout.src"><img name="documentation" src="gfx/mdocumentation.png" alt="documentation"></a>
130     <a id="bugs" href="http://bugs.linuxsampler.org" onmouseover="javascript:if(document.images)document.bugs.src = bugsover.src" onmouseout="javascript:if(document.images)document.bugs.src = bugsout.src"><img name="bugs" src="gfx/mbugs.png" alt="bugs"></a>
131     <a id="instruments" href="instruments.html" onmouseover="javascript:if(document.images)document.instruments.src = instrumentsover.src" onmouseout="javascript:if(document.images)document.instruments.src = instrumentsout.src"><img name="instruments" src="gfx/minstruments.png" alt="instruments"></a>
132     <a id="links" href="links.html" onmouseover="javascript:if(document.images)document.links.src = linksover.src" onmouseout="javascript:if(document.images)document.links.src = linksout.src"><img name="links" src="gfx/mlinks.png" alt="links"></a>
133     <a id="credits" href="credits.html" onmouseover="javascript:if(document.images)document.credits.src = creditsover.src" onmouseout="javascript:if(document.images)document.credits.src = creditsout.src"><img name="credits" src="gfx/mcredits.png" alt="credits"></a>
134 schoenebeck 1935
135     <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="10" height="20">
136    
137     <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
138     <input type="hidden" name="cmd" value="_s-xclick">
139     <input type="hidden" name="hosted_button_id" value="6746056">
140     <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_subscribeCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
141     <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
142     </form>
143    
144     <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
145     <input type="hidden" name="cmd" value="_s-xclick">
146     <input type="hidden" name="hosted_button_id" value="6746149">
147     <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
148     <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
149     </form>
150    
151 senoner 542 </td><td valign=top width="100%">
152     <div id="contents">
153    
154     <h2>FAQ</h2>
155 schoenebeck 1468 <div class="groupbox">
156 senoner 542 Here is a collection of frequently asked questions. Please read them before asking on
157 schoenebeck 896 the mailing list.<br>
158 schoenebeck 1468 <br>
159     1.&nbsp;License<br>
160     &nbsp;&nbsp;&nbsp;&nbsp;1.1&nbsp;<a href="#commercial_products">Can I use LinuxSampler in commercial hardware or software products?</a><br>
161     &nbsp;&nbsp;&nbsp;&nbsp;1.2&nbsp;<a href="#commercial_music">Can I use LinuxSampler for commercial music production?</a><br>
162     &nbsp;&nbsp;&nbsp;&nbsp;1.3&nbsp;<a href="#open_source">LinuxSampler is not open source, you are evil!</a><br>
163 schoenebeck 1469 &nbsp;&nbsp;&nbsp;&nbsp;1.4&nbsp;<a href="#closed_source">Will LinuxSampler turn closed-source?</a><br>
164     &nbsp;&nbsp;&nbsp;&nbsp;1.5&nbsp;<a href="#ls_license_change">I've heard the commercial exception of LinuxSampler was added at a certain version?</a><br>
165     &nbsp;&nbsp;&nbsp;&nbsp;1.6&nbsp;<a href="#ls_breaking_libgig_license">Doesn't LinuxSampler illegally link against libgig?</a><br>
166     &nbsp;&nbsp;&nbsp;&nbsp;1.7&nbsp;<a href="#ls_breaking_license">Doesn't LinuxSampler illegally link against other libraries?</a><br>
167 schoenebeck 1468 2.&nbsp;General Questions<br>
168     &nbsp;&nbsp;&nbsp;&nbsp;2.1&nbsp;<a href="#aga">linuxsampler? qsampler? jsampler? libgig? liblscp? jlscp? ... hu?</a><br>
169     &nbsp;&nbsp;&nbsp;&nbsp;2.2&nbsp;<a href="#no_gui">Can I use linuxsampler without a GUI as well?</a><br>
170     3.&nbsp;Compilation / Installation<br>
171     &nbsp;&nbsp;&nbsp;&nbsp;3.1&nbsp;<a href="#install">What do I need to compile and install?</a><br>
172     &nbsp;&nbsp;&nbsp;&nbsp;3.2&nbsp;<a href="#compilarion_error">Compilation of LinuxSampler aborts with ...</a><br>
173     &nbsp;&nbsp;&nbsp;&nbsp;3.3&nbsp;<a href="#cvs_checkout">How do I checkout from CVS?</a><br>
174     &nbsp;&nbsp;&nbsp;&nbsp;3.4&nbsp;<a href="#compile_cvs">How do I compile from CVS?</a><br>
175     4.&nbsp;Setup<br>
176     &nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp;<a href="#examples_lscp">Are there example LSCP script files somewhere?</a><br>
177     &nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp;<a href="#dropouts">I get dropouts (click sounds, noise), what can I do about it?</a><br>
178 schoenebeck 1586 &nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp;<a href="#runtime_error">LinuxSampler aborts at runtime with ...</a><br>
179 schoenebeck 1468 <br>
180     </div>
181 schoenebeck 896
182     <a name="commercial_products"></a>
183     <h3>Can I use LinuxSampler in commercial hardware or software products?</h3>
184 senoner 702 <p class="default">
185 schoenebeck 703 You are NOT ALLOWED to use LinuxSampler source code, libraries or applications in
186     COMMERCIAL hardware or software products without prior written authorization by the
187     <a href="developers.html">authors</a>. <A HREF="downloads.html">See here</A>
188 schoenebeck 896 </p>
189 senoner 542
190 schoenebeck 896 <a name="commercial_music"></a>
191     <h3>Can I use LinuxSampler for commercial music production?</h3>
192     <p class="default">
193     Hell, yes! Every indirect commercial usage of LinuxSampler, which essentially means
194     using its audio output, can of course be used in commercial applications like music
195     productions, live shows, etc. Don't get us wrong, with the mentioned commercial
196     exception we don't want to restrict the normal user / musician, we just want to avoid
197     somebody to directly make money with our work, that is by selling our software in a
198     sampler product like a sampler + sample library bundle, a hardware sampler or
199     something equivalent, at least not without giving something back to the open source
200     Community.
201     </p>
202    
203     <a name="open_source"></a>
204     <h3>LinuxSampler is not open source, you are evil!</h3>
205     <p class="default">
206     There are of course many definitions of the term "open source", but according to the
207     <a href="http://en.wikipedia.org/wiki/Open_source">definition on Wikipedia</a>
208     LinuxSampler is in fact open source, since you've got complete access to its source
209     code. So due to this fact, a normal user / musician is free to do with LinuxSampler
210     what he likes to do, he can even adjust and tweak every single part of the software
211     by modifying and compiling its source code. And just the fact that we want to avoid
212     our work to be directly exploited in commercial software or hardware products is
213 schoenebeck 897 definitely not an "evil" intention. For the normal user / musician the commercial
214 schoenebeck 896 restriction is even an advantage, since that way commercial actors are forced to
215     support this or another open source project either directly by coding or indirectly
216     by funding and thus increase development speed.
217     </p>
218    
219 schoenebeck 1468 <a name="closed_source"></a>
220     <h3>Will LinuxSampler turn closed-source?</h3>
221     <p class="default">
222     No, LinuxSampler will remain open source. Again, the commercial exception is just to
223     prevent commercial exploitation by third parties that haven't contributed anything to
224     open source projects.
225     </p>
226    
227     <a name="ls_license_change"></a>
228     <h3>I've heard the commercial exception of LinuxSampler was added at a certain version?</h3>
229     <p class="default">
230     No, the commercial exception in LinuxSampler's license terms were there since day one.
231     Even further it's not only there since the very first publicly available CVS
232     (developer) version of LinuxSampler, that commercial exception was even already in
233     Benno Senoner's proof of concept code called "EVO", which LinuxSampler was based on.
234     There was even a rumour that we would have manipulated CVS history to "pretend" this
235     exception wasn't added at a later point. Needless to say that this rumour is completely
236     false as well. Think about it! We're a group of developers spread around the world who
237     work on this project for fun and ideology in our spare time. Most of us contributed to
238     various other open source / free software projects. Do you seriously think we would
239     cheat on such an issue? Beside that you certainly find various people completely
240     unrelated to this project who still have early versions of LinuxSampler and / or EVO
241     and thus can confirm that this commercial exception was always there.
242     </p>
243    
244     <a name="ls_breaking_libgig_license"></a>
245     <h3>Doesn't LinuxSampler illegally link against libgig?</h3>
246     <p class="default">
247     No! LinuxSampler does not "illegally" link against libgig, since the copyright holder
248     (in this case of libgig) has all rights of his work and thus is not bound to his own
249     license terms. The sole purpose of license terms is to grant other people certain
250     rights to use the work.
251     </p>
252    
253     <a name="ls_breaking_license"></a>
254     <h3>Doesn't LinuxSampler illegally link against other libraries?</h3>
255     <p class="default">
256     No, the only library LinuxSampler links to that has license restrictions regarding
257     linking is libgig (<a href="#ls_breaking_libgig_license">see above</a>). Especially
258     LinuxSampler does not break Qt's license terms, since it does not link against Qt at
259     all.
260     </p>
261    
262 schoenebeck 896 <a name="aga"></a>
263 schoenebeck 1404 <h3>linuxsampler? qsampler? jsampler? gigedit? libgig? liblscp? jlscp? ... hu?</h3>
264 senoner 542 <p class="default">
265 schoenebeck 1404 There are currently seven subprojects in the LinuxSampler project; jlscp, jsampler,
266     libgig, liblscp, linuxsampler, gigedit and qsampler. linuxsampler is the core of the sampler, it includes the
267 senoner 542 sampler engines and audio and MIDI drivers. linuxsampler itself is decoupled from any
268 schoenebeck 895 user interface. It offers a native C++ API as well as a network server (LSCP server) to allow to be controlled by
269 schoenebeck 585 an arbitrary user frontend from an arbitrary place over a network connection or
270 schoenebeck 1404 (of course) locally from the same machine as well. This decoupled /
271     <a href="http://en.wikipedia.org/wiki/Backend">"backend"</a> design
272     of the sampler allows to run it even on a machine without any graphical interface,
273     without a Desktop, the machine doesn't even have to have a graphics card!
274     qsampler is the first <a href="http://en.wikipedia.org/wiki/Graphical_user_interface">GUI</a>
275     <a href="http://en.wikipedia.org/wiki/Frontend">frontend</a>
276     written for linuxsampler, it is written in C++ using the Qt
277 senoner 542 GUI library and thus can be compiled for various architectures and operating systems
278 schoenebeck 895 without modifications of the source code.
279 schoenebeck 1404 gigedit is an instruments editor application for Gigasampler format files. You can
280     run it as stand-alone application or in conjunction with LinuxSampler. In the latter
281     case you can play and immediately hear all your modifications made with gigedit in
282     realtime.
283 schoenebeck 895 libgig is a C++ library written for accessing Gigasampler files and DLS Level 1 and 2
284 schoenebeck 897 files, that is for reading and (since version 3.0.0) also writing of those files.
285 schoenebeck 1404 libgig is used by linuxsampler to load Gigasampler files, it is used by gigedit to
286     load, modify and create new Gigasampler files and it <b>can</b> be
287 senoner 542 used by qsampler to retrieve additional informations about Gigasampler files. liblscp
288     is a C library written as a wrapper around the LSCP network protocol, thus to control
289     linuxsampler. It was originally designed to be used on both sides, that is on server /
290     backend side (linuxsampler) and on client / frontend side (e.g. qsampler). But it's now
291 schoenebeck 895 only used on client side by qsampler at the moment. jsampler is another GUI frontend for
292     linuxsampler, it's written in Java and thus platform independent. jlscp is a library which
293     can be compared with liblscp, with the only difference that jlscp is written in Java and
294     liblscp in C. jsampler requires jlscp.
295 schoenebeck 897
296 senoner 542 </p>
297    
298 schoenebeck 896 <a name="install"></a>
299 senoner 542 <h3>What do I need to compile and install?</h3>
300     <p class="default">
301 schoenebeck 585 You should compile and install at least libgig and linuxsampler. As a beginner you should
302 schoenebeck 895 definitely as well compile and install a convenient GUI frontend like either qsampler or
303     jsampler, whatever you prefer. qsampler depends on liblscp, so you have to
304 schoenebeck 1404 compile and install liblscp before starting to build qsampler. Also if you like to be
305     able to edit instruments, you should compile and install gigedit as well. The recommended
306     order to compile and install is:
307 schoenebeck 585 <ol class="default">
308     <li>libgig</li>
309     <li>linuxsampler</li>
310 schoenebeck 1404 <li>gigedit</li>
311 schoenebeck 585 <li>liblscp</li>
312     <li>qsampler</li>
313     </ol>
314 senoner 542 </p>
315 schoenebeck 1404 <p class="default">
316     Of course you can also install QSampler and JSampler side by side. So you can test and use
317     both at the same time.
318     </p>
319 senoner 542
320 schoenebeck 896 <a name="compilarion_error"></a>
321 schoenebeck 616 <h3>Compilation of LinuxSampler aborts with ... </h3>
322 schoenebeck 1404
323 schoenebeck 616 <p class="default">
324 schoenebeck 1404 &bull;&nbsp;&nbsp;&nbsp;"<code>Required libgig version not found...</code>"<br>
325     <br>
326     This error might occur when running LinuxSampler's configure script. Make sure
327     you have the required libgig version installed. If you're compiling a CVS
328     version of LinuxSampler you usually have to compile and install the current
329     CVS version of libgig as well. Also note there are couple common mistakes which
330     let this error occur even after having compiled and installed the required
331     libgig version. Read
332     <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=29">this bug report</a>
333     about common mistakes and how you can fix them.
334     </p>
335    
336     <p class="default">
337 schoenebeck 895 &bull;&nbsp;&nbsp;&nbsp;"<code>can't find a register in class `GENERAL_REGS' while reloading `asm'</code>"<br>
338     <br>
339     This is caused by the inline assembly code for
340     <a href="http://en.wikipedia.org/wiki/SIMD">SIMD</a> optimization in older versions of
341     linuxsampler. You have to compile older versions of LinuxSampler (v0.3.3 and older) with
342     -O2 or -O3 to avoid this problem. Usually this is done by default, if not try:
343     <br>
344 schoenebeck 1279 </p>
345     <pre class="code">CXXFLAGS="-O3" ./configure
346 schoenebeck 618 make</pre>
347 schoenebeck 1279 <p class="default">
348 schoenebeck 618 Alternatively you could also disable all hand-crafted assembly optimization code by:
349 schoenebeck 1279 </p>
350     <pre class="code">./configure --disable-asm
351 schoenebeck 618 make</pre>
352 schoenebeck 1279 <p class="default">
353     but the latter is definitely not recommended, as it will increase CPU usage a lot!
354 schoenebeck 618 </p>
355 schoenebeck 895
356 schoenebeck 807 <p class="default">
357 schoenebeck 895 &bull;&nbsp;&nbsp;&nbsp;"<code>../common/Resampler.h:142: error: memory input 2 is not directly addressable</code>"<br>
358     <br>
359 schoenebeck 807 This was reported (<a href="http://sourceforge.net/mailarchive/forum.php?thread_id=9018347&forum_id=12792">1</a>,
360     <a href="http://sourceforge.net/mailarchive/forum.php?thread_id=9019467&forum_id=12792">2</a>)
361 schoenebeck 895 to be a gcc/g++ version problem, in conjunction with the inline assembly code for
362     <a href="http://en.wikipedia.org/wiki/SIMD">SIMD</a> optimization in older versions of
363     linuxsampler. Make sure you got gcc and g++, both of version 3.3 or higher installed.
364     You can check this with:
365 schoenebeck 1279 </p>
366     <pre class="code">gcc --version
367 schoenebeck 807 g++ --version</pre>
368 schoenebeck 1279 <p class="default">
369 schoenebeck 807 In case you already got gcc and g++ of version 3.3 or higher
370     installed and it still causes the compilation error mentioned
371     above, try the following:
372 schoenebeck 1279 </p>
373     <pre class="code">export CC=`which gcc`
374 schoenebeck 807 export CXX=`which g++`</pre>
375 schoenebeck 1279 <p class="default">
376 schoenebeck 895 On certain systems however you still get this error in conjunction with older
377     versions of LinuxSampler (v0.3.3 and older). Fortunately newer versions of
378     linuxsampler are not affected anymore
379     (<a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=34">read this for details</a>).
380     </p>
381 schoenebeck 616
382 schoenebeck 896 <a name="cvs_checkout"></a>
383 senoner 542 <h3>How do I checkout from CVS?</h3>
384     <p class="default">
385     The procedure of checking out the newest version from CVS is described on the
386 schoenebeck 895 <a href="downloads.html#cvs">Downloads</a> site and on the
387     <a href="http://cvs.linuxsampler.org/cgi-bin/viewcvs.cgi/">web interface site
388     of our CVS server</a>.
389 senoner 542 </p>
390    
391 schoenebeck 896 <a name="compile_cvs"></a>
392 senoner 542 <h3>How do I compile from CVS?</h3>
393     <p class="default">
394     The procedure for compiling from CVS is the same for all subprojects, that is no matter
395 schoenebeck 585 if you are compiling linuxsampler, qsampler, libgig or liblscp from CVS, you need to
396 senoner 542 have the autotools (automake, autoconf and libtool) installed and compile it that way:
397 schoenebeck 1279 <pre class="code">make -f Makefile.cvs
398 senoner 542 ./configure
399     make</pre>
400 schoenebeck 895 </p>
401 senoner 542
402 schoenebeck 896 <a name="no_gui"></a>
403 senoner 542 <h3>Can I use linuxsampler without a GUI as well?</h3>
404     <p class="default">
405 schoenebeck 895 Yes, but unfortunately there is no console based frontend for linuxsampler (yet).
406     You have to write LSCP scripts and send it to the running linuxsampler application. But
407     don't worry, if you don't know how to write LSCP scripts, you can also start by saving
408     a sampler session with QSampler, because the session files qsampler writes are actually
409     real LSCP scripts. You can send a LSCP script to linuxsampler on the console with the
410     following command:
411 schoenebeck 1279 </p>
412 schoenebeck 1404 <pre class="code">netcat localhost 8888 &lt; yourscript.lscp</pre>
413 schoenebeck 1279 <p class="default">
414     or on certain systems (like Debian) you have to provide the -t switch:
415     </p>
416 schoenebeck 1404 <pre class="code">netcat -t localhost 8888 &lt; yourscript.lscp</pre>
417 schoenebeck 1279 <p class="default">
418 senoner 542 Of course you can also replace localhost by the IP address of the machine where
419     linuxsampler is running. Alternatively you can also make a telnet connection (port 8888)
420     to linuxsampler's LSCP server and type commands manually.
421     </p>
422    
423 schoenebeck 896 <a name="examples_lscp"></a>
424 senoner 542 <h3>Are there example LSCP script files somewhere?</h3>
425     <p class="default">
426     Yes, have a look on the <a href="documentation.html">Documentation</a> site for some
427     common LSCP script examples. For details about LSCP read the
428     <a href="api/draft-linuxsampler-protocol.html">LSCP reference</a>. Be welcome to ask
429 schoenebeck 895 questions for details about LSCP on the
430     <a href="http://lists.sourceforge.net/lists/listinfo/linuxsampler-devel">mailing list</a>.
431 senoner 542 </p>
432    
433     <a name="dropouts"></a>
434     <h3>I get dropouts (click sounds, noise), what can I do about it?</h3>
435     <p class="default">
436     In order to achieve good results under Linux you need to have a
437     <a href="http://www.linuxdj.com/audio/lad/resourceslatency.php3">patched kernel</a>.
438     There are different patches available depending on what version (2.4.x or 2.6.x) of kernel you use.
439 schoenebeck 1045 The <a href="http://jackaudio.org/faq">JACK FAQ site</a>
440     (or the <a href="http://jackit.sourceforge.net/docs/faq.php">old JACK FAQ site</a>)
441     is also a good resource for
442 senoner 542 how to configure a realtime stable kernel. But note; LinuxSampler currently has not support for
443     libcap yet, that means if you are still using a 2.4.x Linux kernel you most probably have to run
444 schoenebeck 895 LinuxSampler with root priviliges. As a rule of thumb: if you don't get warnings like "cannot
445     mlockall() memory" on the console, you are safe to run it as ordinary user as well.
446 senoner 542 </p>
447    
448 schoenebeck 1586 <a name="runtime_error"></a>
449     <h3>LinuxSampler aborts at runtime with ... </h3>
450 schoenebeck 1595 <p class="default">
451     Note: For <b>Windows specific runtime errors</b>, please have a
452     look at the
453     <a href="windows.html#houston">Trouble Shooting</a> section of
454     the LinuxSampler Windows HOWTO.
455     </p>
456 schoenebeck 1586
457     <p class="default">
458     &bull;&nbsp;&nbsp;&nbsp;"<code>gig::Engine error: Failed to
459     load instrument, cause: Unknown exception while trying to
460     parse gig file.</code>"<br>
461     <br>
462     Usually LS gives you a meaningful error message in case it
463     failed to load an instrument. However there might be rare
464     cases where LS cannot resolve the reason and you get an
465     error message like above. In this case make sure security /
466     user limits aren't set too low. You can list your current
467     limits with:
468     </p>
469     <pre class="code">ulimit -a</pre>
470     <p class="default">
471     Usually most of those settings are set to "unlimited" on
472     most boxes. If this is not the case on yours, make sure that
473     at least the limits for "max locked memory", "virtual
474     memory" and "data seg size" are sufficiently high enough.
475     The exact value depends on the instruments you want to load.
476     If your security policy allows it, you could simply set
477     those limits to "unlimited" (see also config file
478     /etc/security/limits.conf and
479     <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=41">bug report #41</a>).
480     </p>
481    
482 senoner 542 </div>
483     </td></tr></table>
484    
485     </div>
486    
487     </body>
488     </html>

  ViewVC Help
Powered by ViewVC