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> </head>
<body class="normal"> <body class="normal">
<hr> <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 <p class="normal">SoundTouch library Copyright © Olli Parviainen
2001-2011 </p> 2001-2011 </p>
<hr> <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> integers. See section "sample data format" for more information.</p>
<h3>2.1. Building in Microsoft Windows</h3> <h3>2.1. Building in Microsoft Windows</h3>
<p>Project files for Microsoft Visual C++ 6.0 and Visual C++ .NET are <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 <p> Please notice that SoundTouch library uses processor-specific
optimizations for Pentium III and AMD processors. Visual Studio .NET optimizations for Pentium III and AMD processors. Visual Studio .NET
and later versions supports the required instructions by default, but 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 executables. The make-win.bat script creates these directories
automatically. </p> automatically. </p>
<h3>2.2. Building in Gnu platforms</h3> <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 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 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 disabled and replaced with standard C routines in other processor
platforms.</p> platforms.</p>
<p>To build and install the binaries, run the following commands in the <p>To build and install the binaries, run the following commands in the
SoundTouch/ directory:</p> SoundTouch/ directory:</p>
<table border="0" cellpadding="0" cellspacing="4"> <table border="0" cellpadding="0" cellspacing="4">
<tbody> <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"> <tr valign="top">
<td> <td>
<pre>./configure -</pre> <pre>./configure -</pre>
</td> </td>
<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> </td>
</tr> </tr>
<tr valign="top"> <tr valign="top">
@ -103,10 +116,14 @@ destination locations.</p>
</tbody> </tbody>
</table> </table>
<h4><b>2.2.1 Required GNU tools</b>&nbsp;</h4> <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 are required for compiling the SoundTouch library. These are usually
included with the GNU/Linux distribution, but if not, install these 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> these with the following command:</p>
<pre><b>sudo apt-get install automake autoconf libtool build-essential</b></pre> <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> <h4><b>2.2.2 Problems with GCC compiler compatibility</b></h4>
@ -133,7 +150,8 @@ script and <b>make</b> as usually.</p>
<p>SoundTouch library works also on non-x86 processors.</p> <p>SoundTouch library works also on non-x86 processors.</p>
<p>However, in case that you get compiler errors when trying to compile <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>" 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> 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> <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> <p>After that, run "<b>./bootstrap</b>" script, and then run <b>configure</b>
and <b>make</b> again.</p> and <b>make</b> again.</p>
@ -502,12 +520,20 @@ and estimates the BPM rate:</p>
<hr> <hr>
<h2>5. Change History</h2> <h2>5. Change History</h2>
<h3>5.1. SoundTouch library Change History </h3> <h3>5.1. SoundTouch library Change History </h3>
<p><b>1.5.1pre:</b></p> <p><b>1.6.0:</b></p>
<ul> <ul>
<li> Added automatic cutoff threshold adaptation to beat detection <li> Added automatic cutoff threshold adaptation to beat detection
routine to better adapt BPM calculation to different types of music </li> routine to better adapt BPM calculation to different types of music </li>
<li> Retired 3DNow! optimization support as 3DNow! is nowadays <li> Retired 3DNow! optimization support as 3DNow! is nowadays
obsolete and assembler code is nuisance to maintain.</li> 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 <li>Updated windows build scripts &amp; project files for Visual
Studio 2008 support</li> Studio 2008 support</li>
<li> Updated SoundTouch.dll API for .NET compatibility</li> <li> Updated SoundTouch.dll API for .NET compatibility</li>

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.