e1lama/stk
1
0
Fork 0
mirror of https://github.com/thestk/stk synced 2026-01-19 23:51:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Release 4.4.2 tarball

Browse Source
This commit is contained in:
Gary Scavone
2013-09-29 23:48:48 +02:00
committed by Stephen Sinclair
parent c37de52787
commit 7fcf920d3e
711 changed files with 28790 additions and 16452 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
doc/html/faq.html
View File

@@ -8,13 +8,19 @@
<img src="princeton.gif"> &nbsp; <img src="ccrma.gif"> &nbsp; <img src="mcgill.gif"><P>
<a class="qindex" href="index.html">Home</a> &nbsp; <a class="qindex" href="information.html">Information</a> &nbsp; <a class="qindex" href="classes.html">Classes</a> &nbsp; <a class="qindex" href="download.html">Download</a> &nbsp; <a class="qindex" href="usage.html">Usage</a> &nbsp; <a class="qindex" href="maillist.html">Mail List</a> &nbsp; <a class="qindex" href="system.html">Requirements</a> &nbsp; <a class="qindex" href="links.html">Links</a> &nbsp; <a class="qindex" href="faq.html">FAQ</a> &nbsp; <a class="qindex" href="tutorial.html">Tutorial</a></CENTER>
<HR>
<!-- Generated by Doxygen 1.5.8 -->
<!-- Generated by Doxygen 1.6.2 -->
<div class="contents">
<h1><a class="anchor" name="faq">Frequently Asked Questions </a></h1><ul>
<li><a class="el" href="faq.html#license">Does STK have a license?</a></li><li><a class="el" href="faq.html#filerate">Why is my file sample rate wrong?</a></li><li><a class="el" href="faq.html#endianness">Why does the sound I generated with STK sound like *&amp;#@!?</a></li><li><a class="el" href="faq.html#xwindows">Why do I get a Tk display error message?</a></li></ul>
<h2><a class="anchor" name="license">
<h1><a class="anchor" id="faq">Frequently Asked Questions </a></h1><ul>
<li><a class="el" href="faq.html#license">Does STK have a license?</a></li>
<li><a class="el" href="faq.html#filerate">Why is my file sample rate wrong?</a></li>
<li><a class="el" href="faq.html#endianness">Why does the sound I generated with STK sound like *&amp;#@!?</a></li>
<li><a class="el" href="faq.html#xwindows">Why do I get a Tk display error message?</a></li>
</ul>
<h2><a class="anchor" id="license">
Does STK have a license?</a></h2>
Yes, we finally made something official for release 4.3.0. It is listed in the Stk class and a few other places in the distribution, but I'll repeat it here for clarity:<p>
<p>Yes, we finally made something official for release 4.3.0. It is listed in the Stk class and a few other places in the distribution, but I'll repeat it here for clarity:</p>
<div class="fragment"><pre class="fragment">
The Synthesis ToolKit in C++ (STK) is a set of open source audio
signal processing and algorithmic synthesis classes written in the
@@ -30,7 +36,7 @@ work with any standard C++ compiler.
STK WWW site: http://ccrma.stanford.edu/software/stk/
The Synthesis ToolKit in C++ (STK)
Copyright (c) 1995-2009 Perry R. Cook and Gary P. Scavone
Copyright (c) 1995-2010 Perry R. Cook and Gary P. Scavone
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
@@ -55,26 +61,27 @@ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
</pre></div><h2><a class="anchor" name="filerate">
</pre></div><h2><a class="anchor" id="filerate">
Why is my file sample rate wrong?</a></h2>
When the FileWvIn class loads a soundfile, it automatically sets its internal read increment based on the soundfile rate and the current STK sample rate. For example, if the current STK sample rate is 44100 Hz and the soundfile rate is 22050 Hz, the read increment, or rate, will be set to 0.5 and the file will be interpolated so that is sounds correct at 44100 Hz. For most cases, this works fine. However, consider the following example:<p>
<div class="fragment"><pre class="fragment">FileWvIn input( <span class="stringliteral">"infile"</span> ); <span class="comment">// read an input soundfile</span>
<p>When the FileWvIn class loads a soundfile, it automatically sets its internal read increment based on the soundfile rate and the current STK sample rate. For example, if the current STK sample rate is 44100 Hz and the soundfile rate is 22050 Hz, the read increment, or rate, will be set to 0.5 and the file will be interpolated so that is sounds correct at 44100 Hz. For most cases, this works fine. However, consider the following example:</p>
<div class="fragment"><pre class="fragment">FileWvIn input( <span class="stringliteral">&quot;infile&quot;</span> ); <span class="comment">// read an input soundfile</span>
StkFloat sampleRate = input.getFileRate();
Stk::setSampleRate( sampleRate ); <span class="comment">// set a new STK sample rate based on the file rate</span>
</pre></div><p>
With version 4.3 and higher of STK, the FileWvIn class will be notified of a sample rate change and it will automatically adjust its read rate accordingly. Previous versions of STK did not perform this change and thus, the read rate could end up being incorrect. If you do not want FileWvIn to perform this automatic adjustment, you can call the <code>ignoreSampleRateChange()</code> function for a given class instance.<h2><a class="anchor" name="endianness">
</pre></div><p>With version 4.3 and higher of STK, the FileWvIn class will be notified of a sample rate change and it will automatically adjust its read rate accordingly. Previous versions of STK did not perform this change and thus, the read rate could end up being incorrect. If you do not want FileWvIn to perform this automatic adjustment, you can call the <code>ignoreSampleRateChange()</code> function for a given class instance.</p>
<h2><a class="anchor" id="endianness">
Why does the sound I generated with STK sound like *&amp;#@!?</a></h2>
If the resultant sound generated by an STK program sounds like noise (and you're not doing an MLS experiment), the problem is likely related to the byte "endianness" of your computer. By default, STK assumes "big endian" byte order. If you are working with STK classes on a PC (Windows or Linux), you <em>must</em> define the <code>__LITTLE_ENDIAN__</code> preprocessor definition <em>before</em> compiling. If after reading this you realize you need to make this change, do not forget to recompile all STK classes from scratch.<h2><a class="anchor" name="xwindows">
<p>If the resultant sound generated by an STK program sounds like noise (and you're not doing an MLS experiment), the problem is likely related to the byte "endianness" of your computer. By default, STK assumes "big endian" byte order. If you are working with STK classes on a PC (Windows or Linux), you <em>must</em> define the <code>__LITTLE_ENDIAN__</code> preprocessor definition <em>before</em> compiling. If after reading this you realize you need to make this change, do not forget to recompile all STK classes from scratch.</p>
<h2><a class="anchor" id="xwindows">
Why do I get a Tk display error message?</a></h2>
The following error may be printed to your terminal window (depending on the version of the tcl/tk interpreter you are running) if you attempt to start an STK tcl/tk interface without the X Server first running:<p>
<div class="fragment"><pre class="fragment">Application initialization failed: <span class="keyword">this</span> isn<span class="stringliteral">'t a Tk applicationcouldn'</span>t connect to display <span class="stringliteral">":0.0"</span>
</pre></div><p>
Simply start your X server and then try the command again. </div>
<p>The following error may be printed to your terminal window (depending on the version of the tcl/tk interpreter you are running) if you attempt to start an STK tcl/tk interface without the X Server first running:</p>
<div class="fragment"><pre class="fragment">Application initialization failed: <span class="keyword">this</span> isn<span class="stringliteral">&#39;t a Tk applicationcouldn&#39;</span>t connect to display <span class="stringliteral">&quot;:0.0&quot;</span>
</pre></div><p>Simply start your X server and then try the command again. </p>
</div>
<HR>
<table>
<tr><td><A HREF="http://ccrma.stanford.edu/software/stk/"><I>The Synthesis ToolKit in C++ (STK)</I></A></td></tr>
<tr><td>&copy;1995-2009 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
<tr><td>&copy;1995-2010 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
</table>
</BODY>