mirror of
https://github.com/cookiengineer/audacity
synced 2025-11-03 23:53:55 +01:00
118 lines
3.5 KiB
Plaintext
118 lines
3.5 KiB
Plaintext
Install Instructions for libsamplerate
|
|
======================================
|
|
|
|
The following instructions explain how to install libsamplerate under
|
|
Linux and other Unix like systems including Mac OSX. (For windows,
|
|
see http://www.mega-nerd.com/SRC/win32.html).
|
|
|
|
Preliminaries
|
|
-------------
|
|
1) Included with libsamplerate is a command line program named
|
|
sndfile-resample which uses libnsdile:
|
|
|
|
http://www.mega-nerd.com/libsndfile/
|
|
|
|
for file I/O. If you want to use sndfile-resample you need to
|
|
ensure that libsndfile is correctly installed first. If it is, the
|
|
command "pkg-config --cflags --libs sndfile" should print out
|
|
something like this:
|
|
|
|
-lsndfile
|
|
|
|
If pkg-config doesn't exist you will need need to install it. If
|
|
pkg-config cannot find libsndfile you may need install it. If you
|
|
install from from a Linux distribution package, make sure you also
|
|
install the libsndfile-devel package which contains the header files.
|
|
|
|
If libsndfile is installed, you may need to set the PKG_CONFIG_PATH
|
|
environment variable. If libsndfile is installed in /usr/local/lib,
|
|
you will need to set PKG_CONFIG_PATH using:
|
|
|
|
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
|
|
|
|
Pkg-config should now work. If it doesn't you need to fix it if you
|
|
want to use sndfile-resample.
|
|
|
|
2) The included tests suite for libsamplerate needs libfftw3 which is
|
|
available here:
|
|
|
|
http://www.fftw.org/
|
|
|
|
If FFTW3 is not available, libsamplerate should still compile and
|
|
install without problems but the test suite will not be as
|
|
comprehensive as it normally is.
|
|
|
|
Building
|
|
--------
|
|
Building and verifying libsamplerate is a four or five step process.
|
|
|
|
1) The first step is to run configure
|
|
|
|
./configure
|
|
|
|
which should print out something like the following:
|
|
|
|
checking build system type...
|
|
...
|
|
...
|
|
-=-=-=-=-=-=-=-=-= Configuration Complete =-=-=-=-=-=-=-=-=-=-
|
|
|
|
Configuration summary :
|
|
|
|
Version : ..................... X.Y.Z
|
|
Enable debugging : ............ no
|
|
|
|
Tools :
|
|
|
|
Compiler is GCC : ............. yes
|
|
GCC major version : ........... 3
|
|
|
|
Extra tools required for testing and examples :
|
|
|
|
Use FFTW : .................... yes
|
|
Have libsndfile : ............. yes
|
|
|
|
Installation directories :
|
|
|
|
Library directory : ........... /usr/local/lib
|
|
Program directory : ........... /usr/local/bin
|
|
Pkgconfig directory : ......... /usr/local/lib/pkgconfig
|
|
|
|
Compiling some other packages against libsamplerate may require
|
|
the addition of "/usr/local/lib/pkgconfig" to the
|
|
PKG_CONFIG_PATH environment variable.
|
|
|
|
There are a number of configure options. See the output of
|
|
configure when run with the --help command line option.
|
|
|
|
2) If all goes well with the above then compiling the library can be
|
|
done with
|
|
|
|
make
|
|
|
|
3) When that has finished, the test suite can be run using:
|
|
|
|
make check
|
|
|
|
4) The final step is to install the library. This step needs to be
|
|
carried out as the root user (or with sudo):
|
|
|
|
make install
|
|
|
|
This command will by default install the library in the directory
|
|
/usr/local/lib. It can in installed in other location by using the
|
|
--prefix option in step 1).
|
|
|
|
5) On linux, one more step is required, the registering of the library
|
|
with the system. This is done by running the following command
|
|
(also as the root user):
|
|
|
|
ldconfig -v
|
|
|
|
As a final test, you can run
|
|
|
|
sndfile-resample
|
|
|
|
to make sure everything is installed correctly.
|
|
|