From cfce1434f45e0056690233394c59227989f04110 Mon Sep 17 00:00:00 2001 From: oparviai Date: Mon, 28 Dec 2009 20:51:18 +0000 Subject: [PATCH] Restructured gcc instructions in README.html --- README.html | 68 ++++++++++++++++++++++++++--------------------------- 1 file changed, 33 insertions(+), 35 deletions(-) diff --git a/README.html b/README.html index 3b77074..0255a1c 100644 --- a/README.html +++ b/README.html @@ -110,18 +110,40 @@ binaries to the destination locations.

-

NOTE: At the release time the SoundTouch package has been -tested -to compile in GNU/Linux platform. However, in past it's happened that -new -gcc versions aren't necessarily compatible with the assembler setttings -used in the optimized routines. If you have problems getting the -SoundTouch library compiled, try the workaround of disabling the optimizations by editing the file -"include/STTypes.h" and removing -the following definition there:

+

2.2.1 Required GNU tools 

+

Bash shell, GNU C++ compiler, libtool, autoconf and automake 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 these can be acquired and +installed with the following command:

+
sudo apt-get install automake autoconf libtool build-essential
+

2.2.2 Problems with GCC compiler compatibility

+

At the release time the SoundTouch package has been tested to compile in +GNU/Linux platform. However, in past it's happened that new gcc versions aren't +necessarily compatible with the assembler settings used in the optimized +routines. If you have problems getting the +SoundTouch library compiled, try the workaround of disabling the optimizations +by editing the file "include/STTypes.h" and removing the following +definition there:

#define ALLOW_OPTIMIZATIONS 1
+

2.2.3 Problems with configure script or build process 

+

Incompatibilities between various GNU toolchain versions may cause errors when running the "configure" script or building the source +codes, if your GNU tool versions are not compatible with the versions used for +preparing the SoundTouch kit. 

+

To resolve the issue, regenerate the configure scripts with your local tool +set by running +the "./bootstrap" script included in the SoundTouch source code +kit. After that, run the configure script and make as usually.

+

2.2.4 Compiler issues with non-x86 processors

+

SoundTouch library works also on non-x86 processors.

+

However, in case that you get compiler errors when trying to compile for non-Intel processor, edit the file +"source\SoundTouch\Makefile.am" and remove the "-msse2" +flag on the AM_CXXFLAGS line:

+
AM_CXXFLAGS=-O3 -fcheck-new -I../../include    # Note: -msse2 flag removed!
+

After that, run "./bootstrap" script, and then run configure +and make again.

3. About implementation & Usage tips

3.1. Supported sample data formats

@@ -224,11 +246,11 @@ processing, but in applications processing different kind of sound the default parameter set may result into a sub-optimal result.

The time-stretch algorithm default -parameter values are set by these #defines in file "TDStretch.h":

+parameter values are set by the following #defines in file "TDStretch.h":

#define DEFAULT_SEQUENCE_MS     AUTOMATIC
 #define DEFAULT_SEEKWINDOW_MS   AUTOMATIC
-#define DEFAULT_OVERLAP_MS      12
+#define DEFAULT_OVERLAP_MS 8

These parameters affect to the time-stretch algorithm as follows:

@@ -355,30 +377,6 @@ implemented for Win32 platform only. These optimizations are used in AMD K6-2 and Athlon (classic) CPU's; better performing SSE routines are used with AMD processor starting from Athlon XP. -

3.6 GNU compilation issues

-

3.6.1 Required GNU tools 

-

Bash shell, GNU C++ compiler, libtool, autoconf and automake 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 these can be acquired and -installed with the following command:

-
sudo apt-get install automake autoconf libtool build-essential
-

3.6.2 Problems with configure script or build process 

-

Incompatibilities between various GNU toolchain versions may cause errors when running the "configure" script or building the source -codes, if your GNU tool versions are not compatible with the versions used for -preparing the SoundTouch kit. 

-

To resolve the issue, regenerate the configure scripts with your local tool -set by running -the "./bootstrap" script included in the SoundTouch source code -kit. After that, run the configure script and make as usually.

-

3.6.3 Compiler issues with non-x86 processors

-

SoundTouch library works also on non-x86 processors.

-

However, in case that you get compiler errors when trying to compile for non-Intel processor, edit the file -"source\SoundTouch\Makefile.am" and remove the "-msse2" -flag on the AM_CXXFLAGS line:

-
AM_CXXFLAGS=-O3 -fcheck-new -I../../include    # Note: -msse2 flag removed!
-

After that, run "./bootstrap" script, and then run configure -and make again.

4. SoundStretch audio processing utility