Updated to version 1.6.0

This commit is contained in:
oparviai 2011-07-15 19:19:36 +00:00
parent 1043811c6b
commit 3a6a787b10
2 changed files with 44 additions and 15 deletions

View File

@ -15,7 +15,7 @@
</head>
<body class="normal">
<hr>
<h1>SoundTouch audio processing library v1.6.0pre </h1>
<h1>SoundTouch audio processing library v1.6.0 </h1>
<p class="normal">SoundTouch library Copyright © Olli Parviainen
2001-2011 </p>
<hr>
@ -42,7 +42,8 @@ if it's desirable to use floating point sample data instead of 16bit
integers. See section "sample data format" for more information.</p>
<h3>2.1. Building in Microsoft Windows</h3>
<p>Project files for Microsoft Visual C++ 6.0 and Visual C++ .NET are
supplied with the source code package.&nbsp;</p>
supplied with the source code package.<br>
</p>
<p> Please notice that SoundTouch library uses processor-specific
optimizations for Pentium III and AMD processors. Visual Studio .NET
and later versions supports the required instructions by default, but
@ -62,23 +63,35 @@ be created manually to the SoundTouch package root for the final
executables. The make-win.bat script creates these directories
automatically. </p>
<h3>2.2. Building in Gnu platforms</h3>
<p>The SoundTouch library can be compiled in practically any platform
<p>The SoundTouch library compiles in practically any platform
supporting GNU compiler (GCC) tools. SoundTouch have been tested with
gcc version 3.3.4., but it shouldn't be very specific about the gcc
gcc version 4.4.5 at latest, but it shouldn't be very specific about
the gcc
version. Assembler-level performance optimizations for GNU platform are
currently available in x86 platforms only, they are automatically
currently available in x86 platforms only, and they are automatically
disabled and replaced with standard C routines in other processor
platforms.</p>
<p>To build and install the binaries, run the following commands in the
SoundTouch/ directory:</p>
<table border="0" cellpadding="0" cellspacing="4">
<tbody>
<tr>
<td style="vertical-align: top;">
<pre>./bootstrap -</pre>
</td>
<td style="vertical-align: top;">Creates "configure" file with
local autoconf/automake toolset.<br>
</td>
</tr>
<tr valign="top">
<td>
<pre>./configure -</pre>
</td>
<td>
<p>Configures the SoundTouch package for the local environment.</p>
<p>Configures the SoundTouch package for the local environment.
Notice that "configure" file is not available before running the
"./bootstrap" command as above.<br>
</p>
</td>
</tr>
<tr valign="top">
@ -103,10 +116,14 @@ destination locations.</p>
</tbody>
</table>
<h4><b>2.2.1 Required GNU tools</b>&nbsp;</h4>
<p> Bash shell, GNU C++ compiler, libtool, autoconf and automake tools
<p> <span style="font-weight: bold;">Bash shell</span>, <span
style="font-weight: bold;">GNU C++ compiler</span>, <span
style="font-weight: bold;">libtool</span>, <span
style="font-weight: bold;">autoconf</span> and <span
style="font-weight: bold;">automake</span> tools
are required for compiling the SoundTouch library. These are usually
included with the GNU/Linux distribution, but if not, install these
packages first. For example, in Ubuntu Linux can acquire and install
packages first. For example, Ubuntu Linux can acquire and install
these with the following command:</p>
<pre><b>sudo apt-get install automake autoconf libtool build-essential</b></pre>
<h4><b>2.2.2 Problems with GCC compiler compatibility</b></h4>
@ -132,8 +149,9 @@ script and <b>make</b> as usually.</p>
<h4><b>2.2.4 Compiler issues with non-x86 processors</b></h4>
<p>SoundTouch library works also on non-x86 processors.</p>
<p>However, in case that you get compiler errors when trying to compile
for non-Intel processor, edit the file "<b>source\SoundTouch\Makefile.am</b>"
and remove the "<b>-msse2</b>" flag on the <b>AM_CXXFLAGS </b>line:</p>
for non-Intel processor, edit the file "<b>source\SoundTouch\Makefile.am</b>"
and
remove the "<b>-msse2</b>" flag on the <b>AM_CXXFLAGS </b>line:</p>
<pre><b>AM_CXXFLAGS=-O3 -fcheck-new -I../../include&nbsp;&nbsp;&nbsp; # Note: -msse2 flag removed!</b></pre>
<p>After that, run "<b>./bootstrap</b>" script, and then run <b>configure</b>
and <b>make</b> again.</p>
@ -502,13 +520,21 @@ and estimates the BPM rate:</p>
<hr>
<h2>5. Change History</h2>
<h3>5.1. SoundTouch library Change History </h3>
<p><b>1.5.1pre:</b></p>
<p><b>1.6.0:</b></p>
<ul>
<li> Added automatic cutoff threshold adaptation to beat detection
routine to better adapt BPM calculation to different types of music </li>
<li> Retired 3DNow! optimization support as 3DNow! is nowadays
obsolete and assembler code is nuisance to maintain.</li>
<li> Updated windows build scripts &amp; project files for Visual
obsoleted and assembler code is nuisance to maintain</li>
<li>Retired "configure" file from source code package due to
autoconf/automake versio conflicts, so that it is from now on to be
generated by invoking "boostrap" script that uses locally available
toolchain version for generating the "configure" file</li>
<li>Resolved namespace/label naming conflicts with other libraries by
replacing global labels such as INTEGER_SAMPLES with more specific
SOUNDTOUCH_INTEGER_SAMPLES etc.<br>
</li>
<li>Updated windows build scripts &amp; project files for Visual
Studio 2008 support</li>
<li> Updated SoundTouch.dll API for .NET compatibility</li>
<li> Added API for querying nominal processing input &amp; output
@ -710,8 +736,8 @@ General Public License for more details.</p>
<p>You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA</p>
<hr><!--
$Id$
<hr><!--
$Id$
-->
</body>
</html>

View File

@ -0,0 +1,3 @@
Starting from SoundTouch 1.6.0, the "configure" file is removed from the source code package due to autoconf/automake version conflicts.
Instead, generate the "configure" file using local tools by invoking "./bootstrap" script, then configure & compile as usual.