/[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 1935 by schoenebeck, Sun Jul 12 17:35:36 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                    supportover = new Image();
53                    supportover.src = dir + "msupporthover.png";
54                    supportout = new Image();
55                    supportout.src = dir + "msupport.png";
56    
57                  developersover = new Image();                  developersover = new Image();
58                  developersover.src = dir + "mdevelopershover.png";                  developersover.src = dir + "mdevelopershover.png";
59    
# Line 111  Line 116 
116                          <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>
117                          <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>
118                          <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>
119                            <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>
120                          <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>
121                          <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>
122                          <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 124 
124                          <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>
125                          <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>
126                          <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>
127    
128    <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="10" height="20">
129    
130    <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
131    <input type="hidden" name="cmd" value="_s-xclick">
132    <input type="hidden" name="hosted_button_id" value="6746056">
133    <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!">
134    <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
135    </form>
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="6746149">
140    <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!">
141    <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
142    </form>
143    
144                          </td><td valign=top width="100%">                          </td><td valign=top width="100%">
145                          <div id="contents">                          <div id="contents">
146    
147                          <h2>FAQ</h2>                          <h2>FAQ</h2>
148                          <p class="default">                          <div class="groupbox">
149                                  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
150                                  the mailing list.                                  the mailing list.<br>
151                          </p>                                  <br>
152                          <h3>Can I use LinuxSampler in commercial hardware or software products? </h3>                                  1.&nbsp;License<br>
153                                    &nbsp;&nbsp;&nbsp;&nbsp;1.1&nbsp;<a href="#commercial_products">Can I use LinuxSampler in commercial hardware or software products?</a><br>
154                                    &nbsp;&nbsp;&nbsp;&nbsp;1.2&nbsp;<a href="#commercial_music">Can I use LinuxSampler for commercial music production?</a><br>
155                                    &nbsp;&nbsp;&nbsp;&nbsp;1.3&nbsp;<a href="#open_source">LinuxSampler is not open source, you are evil!</a><br>
156                                    &nbsp;&nbsp;&nbsp;&nbsp;1.4&nbsp;<a href="#closed_source">Will LinuxSampler turn closed-source?</a><br>
157                                    &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>
158                                    &nbsp;&nbsp;&nbsp;&nbsp;1.6&nbsp;<a href="#ls_breaking_libgig_license">Doesn't LinuxSampler illegally link against libgig?</a><br>
159                                    &nbsp;&nbsp;&nbsp;&nbsp;1.7&nbsp;<a href="#ls_breaking_license">Doesn't LinuxSampler illegally link against other libraries?</a><br>
160                                    2.&nbsp;General Questions<br>
161                                    &nbsp;&nbsp;&nbsp;&nbsp;2.1&nbsp;<a href="#aga">linuxsampler? qsampler? jsampler? libgig? liblscp? jlscp? ... hu?</a><br>
162                                    &nbsp;&nbsp;&nbsp;&nbsp;2.2&nbsp;<a href="#no_gui">Can I use linuxsampler without a GUI as well?</a><br>
163                                    3.&nbsp;Compilation / Installation<br>
164                                    &nbsp;&nbsp;&nbsp;&nbsp;3.1&nbsp;<a href="#install">What do I need to compile and install?</a><br>
165                                    &nbsp;&nbsp;&nbsp;&nbsp;3.2&nbsp;<a href="#compilarion_error">Compilation of LinuxSampler aborts with ...</a><br>
166                                    &nbsp;&nbsp;&nbsp;&nbsp;3.3&nbsp;<a href="#cvs_checkout">How do I checkout from CVS?</a><br>
167                                    &nbsp;&nbsp;&nbsp;&nbsp;3.4&nbsp;<a href="#compile_cvs">How do I compile from CVS?</a><br>
168                                    4.&nbsp;Setup<br>
169                                    &nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp;<a href="#examples_lscp">Are there example LSCP script files somewhere?</a><br>
170                                    &nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp;<a href="#dropouts">I get dropouts (click sounds, noise), what can I do about it?</a><br>
171                                    &nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp;<a href="#runtime_error">LinuxSampler aborts at runtime with ...</a><br>
172                                    <br>
173                            </div>
174    
175                            <a name="commercial_products"></a>
176                            <h3>Can I use LinuxSampler in commercial hardware or software products?</h3>
177                          <p class="default">                          <p class="default">
178                          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
179                          COMMERCIAL hardware or software products without prior written authorization by the                          COMMERCIAL hardware or software products without prior written authorization by the
180                          <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>
181                            </p>
182    
183                          <h3>linuxsampler? qsampler? libgig? liblscp? hu?</h3>                          <a name="commercial_music"></a>
184                            <h3>Can I use LinuxSampler for commercial music production?</h3>
185                          <p class="default">                          <p class="default">
186                                  There are currently four subprojects in the LinuxSampler project; linuxsampler,                          Hell, yes! Every indirect commercial usage of LinuxSampler, which essentially means
187                                  qsampler, libgig and liblscp. linuxsampler is the core of the sampler, it includes the                          using its audio output, can of course be used in commercial applications like music
188                            productions, live shows, etc. Don't get us wrong, with the mentioned commercial
189                            exception we don't want to restrict the normal user / musician, we just want to avoid
190                            somebody to directly make money with our work, that is by selling our software in a
191                            sampler product like a sampler + sample library bundle, a hardware sampler or
192                            something equivalent, at least not without giving something back to the open source
193                            Community.
194                            </p>
195    
196                            <a name="open_source"></a>
197                            <h3>LinuxSampler is not open source, you are evil!</h3>
198                            <p class="default">
199                            There are of course many definitions of the term "open source", but according to the
200                            <a href="http://en.wikipedia.org/wiki/Open_source">definition on Wikipedia</a>
201                            LinuxSampler is in fact open source, since you've got complete access to its source
202                            code. So due to this fact, a normal user / musician is free to do with LinuxSampler
203                            what he likes to do, he can even adjust and tweak every single part of the software
204                            by modifying and compiling its source code. And just the fact that we want to avoid
205                            our work to be directly exploited in commercial software or hardware products is
206                            definitely not an "evil" intention. For the normal user / musician the commercial
207                            restriction is even an advantage, since that way commercial actors are forced to
208                            support this or another open source project either directly by coding or indirectly
209                            by funding and thus increase development speed.
210                            </p>
211    
212                            <a name="closed_source"></a>
213                            <h3>Will LinuxSampler turn closed-source?</h3>
214                            <p class="default">
215                            No, LinuxSampler will remain open source. Again, the commercial exception is just to
216                            prevent commercial exploitation by third parties that haven't contributed anything to
217                            open source projects.
218                            </p>
219    
220                            <a name="ls_license_change"></a>
221                            <h3>I've heard the commercial exception of LinuxSampler was added at a certain version?</h3>
222                            <p class="default">
223                            No, the commercial exception in LinuxSampler's license terms were there since day one.
224                            Even further it's not only there since the very first publicly available CVS
225                            (developer) version of LinuxSampler, that commercial exception was even already in
226                            Benno Senoner's proof of concept code called "EVO", which LinuxSampler was based on.
227                            There was even a rumour that we would have manipulated CVS history to "pretend" this
228                            exception wasn't added at a later point. Needless to say that this rumour is completely
229                            false as well. Think about it! We're a group of developers spread around the world who
230                            work on this project for fun and ideology in our spare time. Most of us contributed to
231                            various other open source / free software projects. Do you seriously think we would
232                            cheat on such an issue? Beside that you certainly find various people completely
233                            unrelated to this project who still have early versions of LinuxSampler and / or EVO
234                            and thus can confirm that this commercial exception was always there.
235                            </p>
236    
237                            <a name="ls_breaking_libgig_license"></a>
238                            <h3>Doesn't LinuxSampler illegally link against libgig?</h3>
239                            <p class="default">
240                            No! LinuxSampler does not "illegally" link against libgig, since the copyright holder
241                            (in this case of libgig) has all rights of his work and thus is not bound to his own
242                            license terms. The sole purpose of license terms is to grant other people certain
243                            rights to use the work.
244                            </p>
245    
246                            <a name="ls_breaking_license"></a>
247                            <h3>Doesn't LinuxSampler illegally link against other libraries?</h3>
248                            <p class="default">
249                            No, the only library LinuxSampler links to that has license restrictions regarding
250                            linking is libgig (<a href="#ls_breaking_libgig_license">see above</a>). Especially
251                            LinuxSampler does not break Qt's license terms, since it does not link against Qt at
252                            all.
253                            </p>
254    
255                            <a name="aga"></a>
256                            <h3>linuxsampler? qsampler? jsampler? gigedit? libgig? liblscp? jlscp? ... hu?</h3>
257                            <p class="default">
258                                    There are currently seven subprojects in the LinuxSampler project; jlscp, jsampler,
259                                    libgig, liblscp, linuxsampler, gigedit and qsampler. linuxsampler is the core of the sampler, it includes the
260                                  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
261                                  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
262                                  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
263                                  locally from the same machine as well.                                  (of course) locally from the same machine as well. This decoupled /
264                                  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
265                                    of the sampler allows to run it even on a machine without any graphical interface,
266                                    without a Desktop, the machine doesn't even have to have a graphics card!
267                                    qsampler is the first <a href="http://en.wikipedia.org/wiki/Graphical_user_interface">GUI</a>
268                                    <a href="http://en.wikipedia.org/wiki/Frontend">frontend</a>
269                                    written for linuxsampler, it is written in C++ using the Qt
270                                  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
271                                  without modifications on the source code.                                  without modifications of the source code.
272                                  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
273                                  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
274                                    case you can play and immediately hear all your modifications made with gigedit in
275                                    realtime.
276                                    libgig is a C++ library written for accessing Gigasampler files and DLS Level 1 and 2
277                                    files, that is for reading and (since version 3.0.0) also writing of those files.
278                                    libgig is used by linuxsampler to load Gigasampler files, it is used by gigedit to
279                                    load, modify and create new Gigasampler files and it <b>can</b> be
280                                  used by qsampler to retrieve additional informations about Gigasampler files. liblscp                                  used by qsampler to retrieve additional informations about Gigasampler files. liblscp
281                                  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
282                                  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 /
283                                  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
284                                  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
285                                    linuxsampler, it's written in Java and thus platform independent. jlscp is a library which
286                                    can be compared with liblscp, with the only difference that jlscp is written in Java and
287                                    liblscp in C. jsampler requires jlscp.
288    
289                          </p>                          </p>
290    
291                            <a name="install"></a>
292                          <h3>What do I need to compile and install?</h3>                          <h3>What do I need to compile and install?</h3>
293                          <p class="default">                          <p class="default">
294                                  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
295                                  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
296                                  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
297                                  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
298                                  compile and install is:                                  able to edit instruments, you should compile and install gigedit as well. The recommended
299                                    order to compile and install is:
300                                  <ol class="default">                                  <ol class="default">
301                                    <li>libgig</li>                                    <li>libgig</li>
302                                    <li>linuxsampler</li>                                    <li>linuxsampler</li>
303                                      <li>gigedit</li>
304                                    <li>liblscp</li>                                    <li>liblscp</li>
305                                    <li>qsampler</li>                                    <li>qsampler</li>
306                                  </ol>                                  </ol>
307                          </p>                          </p>
308                            <p class="default">
309                                    Of course you can also install QSampler and JSampler side by side. So you can test and use
310                                    both at the same time.
311                            </p>
312    
313                            <a name="compilarion_error"></a>
314                          <h3>Compilation of LinuxSampler aborts with ... </h3>                          <h3>Compilation of LinuxSampler aborts with ... </h3>
315    
316                          <p class="default">                          <p class="default">
317                                  "<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>
318                                  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>
319                          </p>                                  This error might occur when running LinuxSampler's configure script. Make sure
320                          <table class="default" border="0" cellpadding="1" cellspacing="5">                                  you have the required libgig version installed. If you're compiling a CVS
321                                  <tr>                                  version of LinuxSampler you usually have to compile and install the current
322                                    <td><pre class="code">1                                  CVS version of libgig as well. Also note there are couple common mistakes which
323  2</pre>                                  let this error occur even after having compiled and installed the required
324                                    </td>                                  libgig version. Read
325                                    <td width="100%">                                  <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=29">this bug report</a>
326                                      <pre class="code">CXXFLAGS="-O3" ./configure                                  about common mistakes and how you can fix them.
327                </p>
328    
329                            <p class="default">
330                                            &bull;&nbsp;&nbsp;&nbsp;"<code>can't find a register in class `GENERAL_REGS' while reloading `asm'</code>"<br>
331                                    <br>
332                                    This is caused by the inline assembly code for
333                                    <a href="http://en.wikipedia.org/wiki/SIMD">SIMD</a> optimization in older versions of
334                                    linuxsampler. You have to compile older versions of LinuxSampler (v0.3.3 and older) with
335                                    -O2 or -O3 to avoid this problem. Usually this is done by default, if not try:
336                    <br>
337                </p>
338                            <pre class="code">CXXFLAGS="-O3" ./configure
339  make</pre>  make</pre>
                                   </td>  
                                 </tr>  
                         </table>  
340                          <p class="default">                          <p class="default">
341                                  Alternatively you could also disable all hand-crafted assembly optimization code by:                                  Alternatively you could also disable all hand-crafted assembly optimization code by:
342                          </p>              </p>
343                          <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  
344  make</pre>  make</pre>
                                   </td>  
                                 </tr>  
                         </table>  
345                          <p class="default">                          <p class="default">
346                                  but the latter is definitely not recommended!                              but the latter is definitely not recommended, as it will increase CPU usage a lot!
347                          </p>                          </p>
348    
349                            <p class="default">
350                                    &bull;&nbsp;&nbsp;&nbsp;"<code>../common/Resampler.h:142: error: memory input 2 is not directly addressable</code>"<br>
351                                    <br>
352                                    This was reported (<a href="http://sourceforge.net/mailarchive/forum.php?thread_id=9018347&forum_id=12792">1</a>,
353                                    <a href="http://sourceforge.net/mailarchive/forum.php?thread_id=9019467&forum_id=12792">2</a>)
354                                    to be a gcc/g++ version problem, in conjunction with the inline assembly code for
355                                    <a href="http://en.wikipedia.org/wiki/SIMD">SIMD</a> optimization in older versions of
356                                    linuxsampler. Make sure you got gcc and g++, both of version 3.3 or higher installed.
357                                    You can check this with:
358                </p>
359                            <pre class="code">gcc --version
360    g++ --version</pre>
361                <p class="default">
362                                    In case you already got gcc and g++ of version 3.3 or higher
363                                    installed and it still causes the compilation error mentioned
364                                    above, try the following:
365                </p>
366                            <pre class="code">export CC=`which gcc`
367    export CXX=`which g++`</pre>
368                <p class="default">
369                                    On certain systems however you still get this error in conjunction with older
370                                    versions of LinuxSampler (v0.3.3 and older). Fortunately newer versions of
371                                    linuxsampler are not affected anymore
372                                    (<a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=34">read this for details</a>).
373                            </p>
374    
375                            <a name="cvs_checkout"></a>
376                          <h3>How do I checkout from CVS?</h3>                          <h3>How do I checkout from CVS?</h3>
377                          <p class="default">                          <p class="default">
378                                  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
379                                  <a href="downloads.html">Downloads</a> site.                                  <a href="downloads.html#cvs">Downloads</a> site and on the
380                                    <a href="http://cvs.linuxsampler.org/cgi-bin/viewcvs.cgi/">web interface site
381                                    of our CVS server</a>.
382                          </p>                          </p>
383    
384                            <a name="compile_cvs"></a>
385                          <h3>How do I compile from CVS?</h3>                          <h3>How do I compile from CVS?</h3>
386                          <p class="default">                          <p class="default">
387                                  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
388                                  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
389                                  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:
390                          </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  
391  ./configure  ./configure
392  make</pre>  make</pre>
393                                    </td>                          </p>
                                 </tr>  
                         </table>  
394    
395                            <a name="no_gui"></a>
396                          <h3>Can I use linuxsampler without a GUI as well?</h3>                          <h3>Can I use linuxsampler without a GUI as well?</h3>
397                          <p class="default">                          <p class="default">
398                                  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).
399                                  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
400                                  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
401                          </p>                                  a sampler session with QSampler, because the session files qsampler writes are actually
402                          <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
403                                  <tr>                                  following command:
404                                    <td><pre class="code">1</pre>              </p>
405                                    </td>                          <pre class="code">netcat localhost 8888 &lt; yourscript.lscp</pre>
406                                    <td width="100%">                          <p class="default">
407                                      <pre class="code">cat yourscript.lscp | netcat -t localhost 8888</pre>                  or on certain systems (like Debian) you have to provide the -t switch:
408                                    </td>              </p>
409                                  </tr>                          <pre class="code">netcat -t localhost 8888 &lt; yourscript.lscp</pre>
410                          </table>              <p class="default">
                         <p class="default">  
411                                  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
412                                  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)
413                                  to linuxsampler's LSCP server and type commands manually.                                  to linuxsampler's LSCP server and type commands manually.
414                          </p>                          </p>
415    
416                            <a name="examples_lscp"></a>
417                          <h3>Are there example LSCP script files somewhere?</h3>                          <h3>Are there example LSCP script files somewhere?</h3>
418                          <p class="default">                          <p class="default">
419                                  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
420                                  common LSCP script examples. For details about LSCP read the                                  common LSCP script examples. For details about LSCP read the
421                                  <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
422                                  questions for details about LSCP on the mailing list.                                  questions for details about LSCP on the
423                                    <a href="http://lists.sourceforge.net/lists/listinfo/linuxsampler-devel">mailing list</a>.
424                          </p>                          </p>
425    
426                          <a name="dropouts"></a>                          <a name="dropouts"></a>
# Line 263  make</pre> Line 429  make</pre>
429                                  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
430                                  <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>.
431                                  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.
432                                  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>
433                                    (or the <a href="http://jackit.sourceforge.net/docs/faq.php">old JACK FAQ site</a>)
434                                    is also a good resource for
435                                  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
436                                  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
437                                  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
438                                  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.
439                          </p>                          </p>
440    
441                            <a name="runtime_error"></a>
442                            <h3>LinuxSampler aborts at runtime with ... </h3>
443                            <p class="default">
444                            Note: For <b>Windows specific runtime errors</b>, please have a
445                            look at the
446                            <a href="windows.html#houston">Trouble Shooting</a> section of
447                            the LinuxSampler Windows HOWTO.
448                            </p>
449    
450                            <p class="default">
451                                    &bull;&nbsp;&nbsp;&nbsp;"<code>gig::Engine error: Failed to
452                                    load instrument, cause: Unknown exception while trying to
453                                    parse gig file.</code>"<br>
454                                    <br>
455                                    Usually LS gives you a meaningful error message in case it
456                                    failed to load an instrument. However there might be rare
457                                    cases where LS cannot resolve the reason and you get an
458                                    error message like above. In this case make sure security /
459                                    user limits aren't set too low. You can list your current
460                                    limits with:
461                            </p>
462                            <pre class="code">ulimit -a</pre>
463                            <p class="default">
464                                    Usually most of those settings are set to "unlimited" on
465                                    most boxes. If this is not the case on yours, make sure that
466                                    at least the limits for "max locked memory", "virtual
467                                    memory" and "data seg size" are sufficiently high enough.
468                                    The exact value depends on the instruments you want to load.
469                                    If your security policy allows it, you could simply set
470                                    those limits to "unlimited" (see also config file
471                                    /etc/security/limits.conf and
472                                    <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=41">bug report #41</a>).
473                </p>
474    
475                  </div>                  </div>
476                  </td></tr></table>                  </td></tr></table>
477    

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

  ViewVC Help
Powered by ViewVC