e1lama/stk
1
0
Fork 0
mirror of https://github.com/thestk/stk synced 2026-01-14 21:41:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Release 4.2.0 tarball

Browse Source
This commit is contained in:
Gary Scavone
2013-09-29 23:39:37 +02:00
committed by Stephen Sinclair
parent fe20fe92a2
commit de344668dd
347 changed files with 16972 additions and 8538 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
doc/html/system.html
View File

@@ -11,7 +11,7 @@
<!-- Generated by Doxygen 1.3.4 -->
<h1><a class="anchor" name="system">System Requirements</a></h1><b>General:</b> <ul>
<li>
A MIDI interface to use MIDI input controls. (NOTE: This may be built into the soundcard on your computer.) </li>
A MIDI interface to use MIDI input/output controls. (NOTE: This may be built into the soundcard on your computer.) </li>
<li>
<a href="http://dev.scriptics.com">Tcl/Tk</a> version 8.0 or higher to use the simple Tcl/Tk GUIs provided with the STK distribution (available free over the WWW for all supported realtime platforms). </li>
</ul>
@@ -20,17 +20,19 @@ A MIDI interface to use MIDI input controls. (NOTE: This may be built into the s
<li>
A soundcard to use realtime audio input/output capabilities. In order to use the <em><b>effects</b></em> project, the soundcard and drivers must support full duplex mode. </li>
<li>
<a href="http://www.opensound.com">OSS</a> or <a href="http://www.alsa-project.org/">ALSA</a> device drivers for realtime sound output and MIDI input. </li>
<a href="http://www.alsa-project.org/">ALSA</a> device drivers and library for realtime sound and MIDI input/output. <a href="http://www.opensound.com">OSS</a> device drivers can be used for audio input/output, but MIDI support requires the ALSA library to compile. </li>
</ul>
<p>
<b>Macintosh OS X (specific):</b> <ul>
<li>
A C++ compiler does not ship by default with OS X. It is necessary to download the Developer Kit from the Apple WWW site in order to compile STK. </li>
A C++ compiler does install by default with OS X. It is necessary to download the Developer Kit from the Apple WWW site in order to compile STK or load it from the installation CD-ROM. </li>
<li>
<b>IMPORTANT:</b>The internal Macintosh audio hardware typically supports a sample rate of 44100 Hz only. Therefore, it is necessary to either specify this rate as a command-line option to the STK example programs or to change the default sample rate inside the <a class="el" href="Stk_8h.html">Stk.h</a> file before compilation. In addition, the RT_BUFFER_SIZE, specified in <a class="el" href="Stk_8h.html">Stk.h</a>, could be increased (to a higher power of two) for more robust performance. </li>
<b>IMPORTANT:</b>The internal Macintosh audio hardware typically supports a sample rate of 44100 Hz only. The default STK sample rate is now 44100 Hz, but there may be programs which change that value before execution. Check the program code if you have sample rate conflicts. Many of the example project programs allow the sample rate to be specified via the command line. </li>
<li>
The tcl/tk interpreter does not ship by default with OS X, but must be downloaded from the internet. The latest Tcl/Tk Aqua distribution (<a href="http://www.apple.com/downloads/macosx/unix_open_source/tcltk.html">http://www.apple.com/downloads/macosx/unix_open_source/tcltk.html</a>) has been successfully tested on a 10.2 system. The default installation will place a link to the wish interpretor at /usr/bin/wish.<p>
Initial tests have shown somewhat poor response between changes made in the tcl/tk script and the resulting audio updates. It is possible to connect a tcl/tk interface to an STK program via a socket connection. However, the tcl/tk interpreter does not appear to properly close the socket connection during disconnection. It is therefore necessary to type "Exit" in the STK program terminal window to properly exit the STK program.<p>
If you experience frequent audio input/output "glitches", try increasing the RT_BUFFER_SIZE specified in <a class="el" href="Stk_8h.html">Stk.h</a>. </li>
<li>
The tcl/tk interpreter does not ship by default with OS X, but must be downloaded from the internet. The latest Tcl/Tk Aqua distribution (<a href="http://www.apple.com/downloads/macosx/unix_open_source/tcltk.html">http://www.apple.com/downloads/macosx/unix_open_source/tcltk.html</a>) has been successfully tested on 10.2 and 10.3 systems. The default installation will place a link to the wish interpretor at /usr/bin/wish.<p>
It appears that socket support in Tcl/Tk uses the Nagle algorithm, which produces poor response between changes made in the tcl/tk script and the resulting audio updates. Note that this is only a problem when using a socket connection from a Tcl/Tk script.<p>
</li>
</ul>
<p>
@@ -58,7 +60,7 @@ DirectX support for NT is inadequate, so it is not possible to use STK under Win
<HR>
<table>
<tr><td><A HREF="http://www-ccrma.stanford.edu/software/stk/"><I>The Synthesis ToolKit in C++ (STK)</I></A></td></tr>
<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-2004 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
</table>