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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 703 by schoenebeck, Wed Jul 20 10:33:22 2005 UTC revision 1947 by schoenebeck, Wed Jul 15 09:13:06 2009 UTC
# Line 49  Line 49 
49                  downloadsout = new Image();                  downloadsout = new Image();
50                  downloadsout.src = dir + "mdownloads.png";                  downloadsout.src = dir + "mdownloads.png";
51    
52                    donationsover = new Image();
53                    donationsover.src = dir + "mdonationshover.png";
54    
55                    donationsout = new Image();
56                    donationsout.src = dir + "mdonations.png";
57    
58                    supportover = new Image();
59                    supportover.src = dir + "msupporthover.png";
60                    supportout = new Image();
61                    supportout.src = dir + "msupport.png";
62    
63                  developersover = new Image();                  developersover = new Image();
64                  developersover.src = dir + "mdevelopershover.png";                  developersover.src = dir + "mdevelopershover.png";
65    
# Line 111  Line 122 
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>                          <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>                          <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>                          <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                            <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                            <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                          <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>                          <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>                          <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>                          <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>
# Line 118  Line 131 
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>                          <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>                          <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>                          <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    
135    <div class="boxed">
136    <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
137    <input type="hidden" name="cmd" value="_s-xclick">
138    <input type="hidden" name="hosted_button_id" value="6746056">
139    <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!">
140    <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
141    </form>
142    <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
143    <input type="hidden" name="cmd" value="_s-xclick">
144    <input type="hidden" name="hosted_button_id" value="6746149">
145    <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!">
146    <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
147    </form>
148    <a href="donations.html">Why donate?</a>
149    </div>
150    
151                          </td><td valign=top width="100%">                          </td><td valign=top width="100%">
152                          <div id="contents">                          <div id="contents">
153    
154                          <h2>FAQ</h2>                          <h2>FAQ</h2>
155                          <p class="default">                          <div class="groupbox">
156                                  Here is a collection of frequently asked questions. Please read them before asking on                                  Here is a collection of frequently asked questions. Please read them before asking on
157                                  the mailing list.                                  the mailing list.<br>
158                          </p>                                  <br>
159                          <h3>Can I use LinuxSampler in commercial hardware or software products? </h3>                                  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                                    &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                                    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                                    &nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp;<a href="#runtime_error">LinuxSampler aborts at runtime with ...</a><br>
179                                    <br>
180                            </div>
181    
182                            <a name="commercial_products"></a>
183                            <h3>Can I use LinuxSampler in commercial hardware or software products?</h3>
184                          <p class="default">                          <p class="default">
185                          You are NOT ALLOWED to use LinuxSampler source code, libraries or applications in                          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                          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>                          <a href="developers.html">authors</a>. <A HREF="downloads.html">See here</A>
188                            </p>
189    
190                            <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                            definitely not an "evil" intention. For the normal user / musician the commercial
214                            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                            <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                          <h3>linuxsampler? qsampler? libgig? liblscp? hu?</h3>                          <a name="aga"></a>
263                            <h3>linuxsampler? qsampler? jsampler? gigedit? libgig? liblscp? jlscp? ... hu?</h3>
264                          <p class="default">                          <p class="default">
265                                  There are currently four subprojects in the LinuxSampler project; linuxsampler,                                  There are currently seven subprojects in the LinuxSampler project; jlscp, jsampler,
266                                  qsampler, libgig and liblscp. linuxsampler is the core of the sampler, it includes the                                  libgig, liblscp, linuxsampler, gigedit and qsampler. linuxsampler is the core of the sampler, it includes the
267                                  sampler engines and audio and MIDI drivers. linuxsampler itself is decoupled from any                                  sampler engines and audio and MIDI drivers. linuxsampler itself is decoupled from any
268                                  user interface. It offers a network server (LSCP server) to allow to be controlled by                                  user interface. It offers a native C++ API as well as a network server (LSCP server) to allow to be controlled by
269                                  an arbitrary user frontend from an arbitrary place over a network connection or                                  an arbitrary user frontend from an arbitrary place over a network connection or
270                                  locally from the same machine as well.                                  (of course) locally from the same machine as well. This decoupled /
271                                  qsampler is the first GUI frontend written for linuxsampler, it is written with the Qt                                  <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                                  GUI library and thus can be compiled for various architectures and operating systems                                  GUI library and thus can be compiled for various architectures and operating systems
278                                  without modifications on the source code.                                  without modifications of the source code.
279                                  libgig is a C++ library written for loading Gigasampler files and DLS Level 1 and 2                                  gigedit is an instruments editor application for Gigasampler format files. You can
280                                  files. libgig is used by linuxsampler to load Gigasampler files and it <b>can</b> be                                  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                                    libgig is a C++ library written for accessing Gigasampler files and DLS Level 1 and 2
284                                    files, that is for reading and (since version 3.0.0) also writing of those files.
285                                    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                                  used by qsampler to retrieve additional informations about Gigasampler files. liblscp                                  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                                  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 /                                  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                                  backend side (linuxsampler) and on client / frontend side (e.g. qsampler). But it's now
291                                  only used on client side by qsampler at the moment.                                  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    
296                          </p>                          </p>
297    
298                            <a name="install"></a>
299                          <h3>What do I need to compile and install?</h3>                          <h3>What do I need to compile and install?</h3>
300                          <p class="default">                          <p class="default">
301                                  You should compile and install at least libgig and linuxsampler. As a beginner you should                                  You should compile and install at least libgig and linuxsampler. As a beginner you should
302                                  definitely as well compile and install liblscp and qsampler. qsampler is a                                  definitely as well compile and install a convenient GUI frontend like either qsampler or
303                                  convenient GUI frontend for linuxsampler. qsampler depends on liblscp, so you have to                                  jsampler, whatever you prefer. qsampler depends on liblscp, so you have to
304                                  compile and install liblscp before starting to build qsampler. The recommended order to                                  compile and install liblscp before starting to build qsampler. Also if you like to be
305                                  compile and install is:                                  able to edit instruments, you should compile and install gigedit as well. The recommended
306                                    order to compile and install is:
307                                  <ol class="default">                                  <ol class="default">
308                                    <li>libgig</li>                                    <li>libgig</li>
309                                    <li>linuxsampler</li>                                    <li>linuxsampler</li>
310                                      <li>gigedit</li>
311                                    <li>liblscp</li>                                    <li>liblscp</li>
312                                    <li>qsampler</li>                                    <li>qsampler</li>
313                                  </ol>                                  </ol>
314                          </p>                          </p>
315                            <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    
320                            <a name="compilarion_error"></a>
321                          <h3>Compilation of LinuxSampler aborts with ... </h3>                          <h3>Compilation of LinuxSampler aborts with ... </h3>
322    
323                          <p class="default">                          <p class="default">
324                                  "<code>can't find a register in class `GENERAL_REGS' while reloading `asm'</code>"<br>                                  &bull;&nbsp;&nbsp;&nbsp;"<code>Required libgig version not found...</code>"<br>
325                                  This is caused by the inline assembly code for SIMD optimization. You currently have to compile LinuxSampler with -O2 or -O3 to avoid this problem. Usually this done by default, if not try:                                  <br>
326                          </p>                                  This error might occur when running LinuxSampler's configure script. Make sure
327                          <table class="default" border="0" cellpadding="1" cellspacing="5">                                  you have the required libgig version installed. If you're compiling a CVS
328                                  <tr>                                  version of LinuxSampler you usually have to compile and install the current
329                                    <td><pre class="code">1                                  CVS version of libgig as well. Also note there are couple common mistakes which
330  2</pre>                                  let this error occur even after having compiled and installed the required
331                                    </td>                                  libgig version. Read
332                                    <td width="100%">                                  <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=29">this bug report</a>
333                                      <pre class="code">CXXFLAGS="-O3" ./configure                                  about common mistakes and how you can fix them.
334                </p>
335    
336                            <p class="default">
337                                            &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                </p>
345                            <pre class="code">CXXFLAGS="-O3" ./configure
346  make</pre>  make</pre>
                                   </td>  
                                 </tr>  
                         </table>  
347                          <p class="default">                          <p class="default">
348                                  Alternatively you could also disable all hand-crafted assembly optimization code by:                                  Alternatively you could also disable all hand-crafted assembly optimization code by:
349                          </p>              </p>
350                          <table class="default" border="0" cellpadding="1" cellspacing="5">                          <pre class="code">./configure --disable-asm
                                 <tr>  
                                   <td><pre class="code">1  
 2</pre>  
                                   </td>  
                                   <td width="100%">  
                                     <pre class="code">./configure --disable-asm  
351  make</pre>  make</pre>
                                   </td>  
                                 </tr>  
                         </table>  
352                          <p class="default">                          <p class="default">
353                                  but the latter is definitely not recommended!                              but the latter is definitely not recommended, as it will increase CPU usage a lot!
354                            </p>
355    
356                            <p class="default">
357                                    &bull;&nbsp;&nbsp;&nbsp;"<code>../common/Resampler.h:142: error: memory input 2 is not directly addressable</code>"<br>
358                                    <br>
359                                    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                                    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                </p>
366                            <pre class="code">gcc --version
367    g++ --version</pre>
368                <p class="default">
369                                    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                </p>
373                            <pre class="code">export CC=`which gcc`
374    export CXX=`which g++`</pre>
375                <p class="default">
376                                    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>                          </p>
381    
382                            <a name="cvs_checkout"></a>
383                          <h3>How do I checkout from CVS?</h3>                          <h3>How do I checkout from CVS?</h3>
384                          <p class="default">                          <p class="default">
385                                  The procedure of checking out the newest version from CVS is described on the                                  The procedure of checking out the newest version from CVS is described on the
386                                  <a href="downloads.html">Downloads</a> site.                                  <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                          </p>                          </p>
390    
391                            <a name="compile_cvs"></a>
392                          <h3>How do I compile from CVS?</h3>                          <h3>How do I compile from CVS?</h3>
393                          <p class="default">                          <p class="default">
394                                  The procedure for compiling from CVS is the same for all subprojects, that is no matter                                  The procedure for compiling from CVS is the same for all subprojects, that is no matter
395                                  if you are compiling linuxsampler, qsampler, libgig or liblscp from CVS, you need to                                  if you are compiling linuxsampler, qsampler, libgig or liblscp from CVS, you need to
396                                  have the autotools (automake, autoconf and libtool) installed and compile it that way:                                  have the autotools (automake, autoconf and libtool) installed and compile it that way:
397                          </p>                                  <pre class="code">make -f Makefile.cvs
                         <table class="default" border="0" cellpadding="1" cellspacing="5">  
                                 <tr>  
                                   <td><pre class="code">1  
 2  
 3</pre>  
                                   </td>  
                                   <td width="100%">  
                                     <pre class="code">make -f Makefile.cvs  
398  ./configure  ./configure
399  make</pre>  make</pre>
400                                    </td>                          </p>
                                 </tr>  
                         </table>  
401    
402                            <a name="no_gui"></a>
403                          <h3>Can I use linuxsampler without a GUI as well?</h3>                          <h3>Can I use linuxsampler without a GUI as well?</h3>
404                          <p class="default">                          <p class="default">
405                                  Yes, but unfortunately there is no console based frontend frontend for linuxsampler (yet).                                  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.                                  You have to write LSCP scripts and send it to the running linuxsampler application. But
407                                  You can send a LSCP script to linuxsampler on the console with the following command:                                  don't worry, if you don't know how to write LSCP scripts, you can also start by saving
408                          </p>                                  a sampler session with QSampler, because the session files qsampler writes are actually
409                          <table class="default" border="0" cellpadding="1" cellspacing="5">                                  real LSCP scripts. You can send a LSCP script to linuxsampler on the console with the
410                                  <tr>                                  following command:
411                                    <td><pre class="code">1</pre>              </p>
412                                    </td>                          <pre class="code">netcat localhost 8888 &lt; yourscript.lscp</pre>
413                                    <td width="100%">                          <p class="default">
414                                      <pre class="code">cat yourscript.lscp | netcat -t localhost 8888</pre>                  or on certain systems (like Debian) you have to provide the -t switch:
415                                    </td>              </p>
416                                  </tr>                          <pre class="code">netcat -t localhost 8888 &lt; yourscript.lscp</pre>
417                          </table>              <p class="default">
                         <p class="default">  
418                                  Of course you can also replace localhost by the IP address of the machine where                                  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)                                  linuxsampler is running. Alternatively you can also make a telnet connection (port 8888)
420                                  to linuxsampler's LSCP server and type commands manually.                                  to linuxsampler's LSCP server and type commands manually.
421                          </p>                          </p>
422    
423                            <a name="examples_lscp"></a>
424                          <h3>Are there example LSCP script files somewhere?</h3>                          <h3>Are there example LSCP script files somewhere?</h3>
425                          <p class="default">                          <p class="default">
426                                  Yes, have a look on the <a href="documentation.html">Documentation</a> site for some                                  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                                  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                                  <a href="api/draft-linuxsampler-protocol.html">LSCP reference</a>. Be welcome to ask
429                                  questions for details about LSCP on the mailing list.                                  questions for details about LSCP on the
430                                    <a href="http://lists.sourceforge.net/lists/listinfo/linuxsampler-devel">mailing list</a>.
431                          </p>                          </p>
432    
433                          <a name="dropouts"></a>                          <a name="dropouts"></a>
# Line 263  make</pre> Line 436  make</pre>
436                                  In order to achieve good results under Linux you need to have a                                  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>.                                  <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.                                  There are different patches available depending on what version (2.4.x or 2.6.x) of kernel you use.
439                                  The <a href="http://jackit.sourceforge.net/docs/faq.php">JACK FAQ site</a> is also a good resource                                  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                                  how to configure a realtime stable kernel. But note; LinuxSampler currently has not support for                                  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                                  libcap yet, that means if you are still using a 2.4.x Linux kernel you most probably have to run
444                                  LinuxSampler with root priviliges (support for libcap is planned though). As a rule of thumb: if                                  LinuxSampler with root priviliges. As a rule of thumb: if you don't get warnings like "cannot
445                                  you don't get warnings like "cannot mlockall() memory" you are safe to run it as ordinary user as well.                                  mlockall() memory" on the console, you are safe to run it as ordinary user as well.
446                          </p>                          </p>
447    
448                            <a name="runtime_error"></a>
449                            <h3>LinuxSampler aborts at runtime with ... </h3>
450                            <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    
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                  </div>                  </div>
483                  </td></tr></table>                  </td></tr></table>
484    

Legend:
Removed from v.703  
changed lines
  Added in v.1947

  ViewVC Help
Powered by ViewVC