mirror of
https://github.com/thestk/stk
synced 2026-01-11 20:11:52 +00:00
Version 4.3.1
This commit is contained in:
Gary Scavone
committed by
Stephen Sinclair
Stephen Sinclair
parent
27d9b79dc7
commit
d199342e86
@@ -7,11 +7,11 @@ Please read the file README for more general STK information.
|
||||
DirectX and WindowsNT Issues:
|
||||
-----------------------------
|
||||
|
||||
STK is currently distributed with Visual C++ .NET project and workspace files. It no longer compiles with Visual C++ 6.0. I gave up attempting to fix all the problems created by such a bad compiler. This version of STK has been tested using Visual C++ .NET.
|
||||
STK is currently distributed with Visual C++ .NET project and workspace files. It no longer compiles with Visual C++ 6.0. I gave up attempting to fix all the problems created by such a bad compiler. This version of STK has been tested using Visual C++ .NET. As well, the configure script now supprots MinGW.
|
||||
|
||||
IMPORTANT VC++ NOTE: When compiling "release" versions of STK programs, link to the release multithreaded library. When compiling "debug" versions, link to the debug multithreaded library. Compiler errors will result otherwise. Also, the Microsoft folk are up to their old habits of trying to change standards. The .NET compiler will complain about cerr for some reason.
|
||||
|
||||
Both the DirectSound and Steinberg ASIO audio APIs are supported for realtime audio input/output. The Visual C++ project files included with this distribution are configured to use the DirectSound API. In order to use the ASIO API, it is necessary to change the preprocessor definition from __WINDOWS_DS__ to __WINDOWS_ASIO__, as well as include all the files in the /src/asio/ directory (i.e. asio.h, asio.cpp, ...). If you have a good quality soundcard and a native ASIO driver (not emulated), you are likely to get much better input/output response using that.
|
||||
Both the DirectSound and Steinberg ASIO audio APIs are supported for realtime audio input/output. The Visual C++ project files included with this distribution are configured to use the DirectSound API. In order to use the ASIO API, it is necessary to change the preprocessor definition from __WINDOWS_DS__ to __WINDOWS_ASIO__, as well as include all the files in the /src/include/ directory (i.e. asio.h, asio.cpp, ...). If you have a good quality soundcard and a native ASIO driver (not emulated), you are likely to get much better input/output response using that.
|
||||
|
||||
When using the DirectSound API for audio input, latency is typically pretty horrendous (should we be surprised?). Also, there is a slight chance you don't have DirectSoundCapture support on your computer. If not, you should download the DirectX 6.0 (or higher) runtime libraries from Microsoft's WWW site (http://www.microsoft.com/directx/download.asp) in order to run the pre-compiled STK executables for Windoze. The last time I checked, there was no DirectSoundCapture support for WindowsNT ... you'll have to switch to Windows 2000 or XP or use an ASIO driver. I stopped supporting the WinMM audio output code with release 3.2.
|
||||
|
||||
|
||||
@@ -2,6 +2,14 @@ The Synthesis ToolKit in C++ (STK)
|
||||
|
||||
By Perry R. Cook and Gary P. Scavone, 1995-2007.
|
||||
|
||||
v4.3.1: (7 December 2007)
|
||||
- further headerless file support in FileRead
|
||||
- bug fix in RtWvOut.cpp
|
||||
- added configure support for MinGW
|
||||
- updates to RtAudio and RtMidi for MinGW
|
||||
- changes to channel assignment in demo.cpp
|
||||
|
||||
|
||||
v4.3.0: (13 August 2007)
|
||||
- an official MIT-like license
|
||||
- new functionality to automatically update class data when the STK sample rate changes (partly implemented)
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
# Project related configuration options
|
||||
#---------------------------------------------------------------------------
|
||||
PROJECT_NAME = STK
|
||||
PROJECT_NUMBER = 4.3
|
||||
PROJECT_NUMBER = 4.3.1
|
||||
OUTPUT_DIRECTORY = .
|
||||
CREATE_SUBDIRS = NO
|
||||
OUTPUT_LANGUAGE = English
|
||||
|
||||
@@ -1,16 +1,26 @@
|
||||
/*! \page download Download, Release Notes, and Bug Fixes
|
||||
|
||||
\section down Download Version 4.3.0 (13 August 2007):
|
||||
\section down Download Version 4.3.1 (7 December 2007):
|
||||
|
||||
<UL>
|
||||
<LI><A HREF="http://ccrma.stanford.edu/software/stk/release/stk-4.3.0.tar.gz">Source distribution</A></LI>
|
||||
<LI><A HREF="http://ccrma.stanford.edu/software/stk/release/stk-4.3.0.binaries.tar.gz">Source with precompiled Windows binaries</A></LI>
|
||||
<LI><A HREF="http://ccrma.stanford.edu/software/stk/release/stk-4.3.1.tar.gz">Source distribution</A></LI>
|
||||
<LI><A HREF="http://ccrma.stanford.edu/planetccrma/software/">Linux RPMs from Planet CCRMA</A></LI>
|
||||
</UL>
|
||||
|
||||
|
||||
\section notes Release Notes:
|
||||
|
||||
\subsection v4dot3dot0 Version 4.3.1
|
||||
|
||||
<ul>
|
||||
<li>Further headerless file support in FileRead.</li>
|
||||
<li>Bug fix in RtWvOut.cpp.</li>
|
||||
<li>Added configure support for MinGW.</li>
|
||||
<li>Updates to RtAudio and RtMidi for MinGW.</li>
|
||||
<li>Changes to channel assignment in demo.cpp.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
\subsection v4dot3dot0 Version 4.3.0
|
||||
|
||||
<ul>
|
||||
|
||||
@@ -11,6 +11,23 @@
|
||||
|
||||
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:
|
||||
|
||||
\verbatim
|
||||
The Synthesis ToolKit in C++ (STK) is a set of open source audio
|
||||
signal processing and algorithmic synthesis classes written in the
|
||||
C++ programming language. STK was designed to facilitate rapid
|
||||
development of music synthesis and audio processing software, with
|
||||
an emphasis on cross-platform functionality, realtime control,
|
||||
ease of use, and educational example code. STK currently runs
|
||||
with realtime support (audio and MIDI) on Linux, Macintosh OS X,
|
||||
and Windows computer platforms. Generic, non-realtime support has
|
||||
been tested under NeXTStep, Sun, and other platforms and should
|
||||
work with any standard C++ compiler.
|
||||
|
||||
STK WWW site: http://ccrma.stanford.edu/software/stk/
|
||||
|
||||
The Synthesis ToolKit in C++ (STK)
|
||||
Copyright (c) 1995-2007 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
|
||||
"Software"), to deal in the Software without restriction, including
|
||||
@@ -34,6 +51,7 @@ 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.
|
||||
\endverbatim
|
||||
|
||||
\section filerate Why is my file sample rate wrong?
|
||||
|
||||
|
||||
175
doc/treesed.html
175
doc/treesed.html
@@ -1,175 +0,0 @@
|
||||
<html>
|
||||
<head>
|
||||
<title>Treesed Usage</title>
|
||||
</head>
|
||||
<body>
|
||||
<table border="0" width="660" cellpadding="0" cellspacing="0">
|
||||
<tbody><tr valign="top"><td width="165">
|
||||
|
||||
<h3>How to Use Treesed</h3>
|
||||
|
||||
Go to the directory where you want to search or make changes.
|
||||
|
||||
<p>
|
||||
There are two choices you can make when using treesed:
|
||||
</p><ol>
|
||||
<li>Do I just want to search for a text, or do I want to search for a
|
||||
text and replace it with something else?
|
||||
<br>
|
||||
If you are just searching you are using Treesed in "search mode", otherwise it is in
|
||||
"replace mode."
|
||||
</li><li>Do I want to search/replace only in files in my current directory,
|
||||
or should files in all subdirectories (and all directories below that)
|
||||
also be done?
|
||||
</li></ol>
|
||||
Some examples will make this clear.
|
||||
|
||||
<h4>Searching</h4>
|
||||
Say you are faced with the situation that the author of a slew of web-pages, Nathan Brazil, has left and has been succeeded by Mavra Chang. First, let us see which files are affected by this (what you type in is shown in <b><tt>bold</tt></b>):
|
||||
<blockquote>
|
||||
<pre>[localhost] <b>treesed "Nathan Brazil" -files *.html</b>
|
||||
search_pattern: Nathan\ Brazil
|
||||
replacement_pattern:
|
||||
|
||||
** Search mode
|
||||
|
||||
.
|
||||
midnight.html: 1 lines on: 2
|
||||
..
|
||||
well.html: 1 lines on: 3
|
||||
</pre>
|
||||
</blockquote>
|
||||
We notice the following:
|
||||
<ul>
|
||||
<li>The search text <tt>"Nathan Brazil"</tt> is enclosed in
|
||||
double-quotes (<tt>"</tt>).
|
||||
</li><li>You specify which files to search with <tt>-files</tt> followed by a
|
||||
list of file names--in this case <tt>*.html</tt>.
|
||||
</li><li>Treesed reports the search pattern ("pattern" is just a fancy word
|
||||
for "text") you specified (you can ignore
|
||||
that \).
|
||||
</li><li>Treesed reports an empty <tt>replacement_pattern</tt>. This is
|
||||
correct, because you haven't entered one.
|
||||
</li><li>It therefore deduces that is is in search mode.
|
||||
</li><li>It finds two files containing "Nathan Brazil", and reports on which
|
||||
lines of these files it found it; it does not show the lines themselves.
|
||||
</li></ul>
|
||||
Because you used <tt>-files</tt>, Treesed will search in the files you
|
||||
specify <i>in the current directory</i>. You can also search files in
|
||||
the current directory <i>and</i> all directories below it. However, in
|
||||
that case you can not specify which file names to use, all files will be
|
||||
searched:
|
||||
<blockquote>
|
||||
<pre>[localhost] <b>treesed "Nathan Brazil" -tree</b>
|
||||
search_pattern: Nathan\ Brazil
|
||||
replacement_pattern:
|
||||
|
||||
** Search mode
|
||||
|
||||
.
|
||||
midnight.html: 1 lines on: 2
|
||||
...
|
||||
well.html: 1 lines on: 3
|
||||
.
|
||||
new/echoes.html: 1 lines on: 2
|
||||
</pre>
|
||||
</blockquote>
|
||||
We notice the following:
|
||||
<ul>
|
||||
<li>Instead of <tt>-files</tt> we now see <tt>-tree</tt>.
|
||||
</li><li>We do not see a specification of file names.
|
||||
</li><li>Treesed finds an occurence of "Nathan Brazil" in the file
|
||||
<tt>echoes.html</tt> in the subdirectory <tt>new</tt>; it did not
|
||||
find this file in the previous example (as it shouldn't).
|
||||
</li></ul>
|
||||
|
||||
<h4>Replacing</h4>
|
||||
To replace a text you simply add the replacement text right after the
|
||||
search text:
|
||||
<blockquote>
|
||||
<pre>[localhost] <b>treesed "Nathan Brazil" "Mavra Change" -files *.html</b>
|
||||
search_pattern: Nathan\ Brazil
|
||||
replacement_pattern: Mavra Chang
|
||||
|
||||
** EDIT MODE!
|
||||
|
||||
.
|
||||
midnight.html: 1 lines on: 2
|
||||
|
||||
Replaced Nathan\ Brazil by Mavra Chang on 1 lines in midnight.html
|
||||
..
|
||||
well.html: 1 lines on: 3
|
||||
|
||||
Replaced Nathan\ Brazil by Mavra Chang on 1 lines in well.html
|
||||
</pre>
|
||||
</blockquote>
|
||||
We notice the following:
|
||||
<ul>
|
||||
<li>Right after the search text "Nathan Brazil" you specify the
|
||||
replacement text "Mavra Chang".
|
||||
</li><li>As a result, Treesed now reports a non-empty
|
||||
<tt>replacement_pattern</tt>.
|
||||
</li><li>Hence it concludes it is in "edit mode", which means replacment mode.
|
||||
</li><li>Treesed dutifully reports on which lines in which files it did the
|
||||
replacement.
|
||||
</li></ul>
|
||||
To replace a text in all files in the current directory and the ones
|
||||
below it, we do the following:
|
||||
<blockquote>
|
||||
<pre>[localhost] <b>treesed "Nathan Brazil" "Mavra Chang" -tree</b>
|
||||
search_pattern: Nathan\ Brazil
|
||||
replacement_pattern: Mavra Chang
|
||||
|
||||
** EDIT MODE!
|
||||
|
||||
.
|
||||
midnight.html: 1 lines on: 2
|
||||
|
||||
Replaced Nathan\ Brazil by Mavra Chang on 1 lines in midnight.html
|
||||
|
||||
....
|
||||
well.html: 1 lines on: 3
|
||||
|
||||
Replaced Nathan\ Brazil by Mavra Chang on 1 lines in well.html
|
||||
.
|
||||
new/echoes.html: 1 lines on: 2
|
||||
|
||||
Replaced Nathan\ Brazil by Mavra Chang on 1 lines in new/echoes.html
|
||||
</pre>
|
||||
</blockquote>
|
||||
and we get the expected results, including the replace in
|
||||
<tt>new/echoes.html</tt>.
|
||||
|
||||
<h4>Old Versions</h4>
|
||||
Treesed leaves behind quite a mess of old versions of the files it
|
||||
changed (only in change-mode, of course). These old files have the same
|
||||
name as the original file, with <tt>.ddddd</tt> appended to it. For
|
||||
example, if treesed makes a change to <tt>midnight.html</tt> it will
|
||||
leave the original version as something like
|
||||
<tt>midnight.html.26299</tt>. You'll have to remove these files lest
|
||||
your disk area clutters up. Here is a command that does that, <b>but
|
||||
beware!</b> This command removes all files in the current directory and
|
||||
all below it, that end in a period followed by one or more
|
||||
digits:
|
||||
<blockquote>
|
||||
<pre>find . -name "*.[0-9]*" -exec rm {} \;
|
||||
</pre>
|
||||
</blockquote>
|
||||
|
||||
It is interesting to note that if you use treesed again without cleaning
|
||||
up, you may get files like <tt>midnight.html.26299.27654</tt>. These
|
||||
will also be cleaned up by the above slightly dangerous command.
|
||||
|
||||
|
||||
<h3>About Treesed</h3>
|
||||
<tt>treesed</tt> is public domain software developed
|
||||
and designed by Rick Jansen from Sara, Amsterdam, Netherlands, January
|
||||
1996.
|
||||
|
||||
<p>
|
||||
|
||||
<h3>About This Document</h3>
|
||||
This usage document was created by the Division of Information Technology Services at The
|
||||
University of Western Ontario.
|
||||
|
||||
</body></html>
|
||||
Reference in New Issue
Block a user