mirror of
https://gitee.com/openharmony/third_party_libsnd
synced 2024-11-23 09:59:54 +00:00
9ebb96ca72
* Add win32_ordinal_test to test suite * Add examples targets * Add sndfile-regtest target * Improve compatibility with MSVC * Check direct.h header * Add define to enable math constants * Don't use CTest if tests are disabled * Make packaging configurable * Suppress annoying MSVC warnings * Add ENABLE_BOW_DOCS option * Add ENABLE_STATIC_RUNTIME option * Add package config support * Tune large files support messages * Don't build tests when static libs disabled * Use VS solution folders feature * Fix option value set twice * Rename sndfile target to sndfile-shared * Mark M_LIBRARY variable as advanced * Fix config packages installation directory * Rename ENABLE_PACKAGING option for clarity * CPack fixes * Add CMake modules to Makefile.am * Update documentation Closes: https://github.com/erikd/libsndfile/issues/71
164 lines
6.0 KiB
Markdown
164 lines
6.0 KiB
Markdown
# libsndfile
|
|
|
|
[](http://travis-ci.org/erikd/libsndfile)
|
|
|
|
libsndfile is a C library for reading and writing files containing sampled audio
|
|
data.
|
|
|
|
## Hacking
|
|
|
|
The canonical source code repository for libsndfile is at
|
|
[https://github.com/erikd/libsndfile/][github].
|
|
|
|
You can grab the source code using:
|
|
|
|
$ git clone git://github.com/erikd/libsndfile.git
|
|
|
|
For building for Android see [BuildingForAndroid][BuildingForAndroid].
|
|
|
|
There are currently two build systems; the official GNU autotool based one and
|
|
a more limited and experimental CMake based build system. Use of the CMake build
|
|
system is documented below.
|
|
|
|
Setting up a build environment for libsndfile on Debian or Ubuntu is as simple as:
|
|
```
|
|
sudo apt install autoconf autogen automake build-essential libasound2-dev \
|
|
libflac-dev libogg-dev libtool libvorbis-dev pkg-config python
|
|
````
|
|
For other Linux distributions or any of the *BSDs, the setup should be similar
|
|
although the package install tools and package names may be slightly different.
|
|
|
|
Similarly on Mac OS X, assuming [brew] is already installed:
|
|
```
|
|
brew install autoconf autogen automake flac libogg libtool libvorbis pkg-config
|
|
```
|
|
Once the build environment has been set up, building and testing libsndfile is
|
|
as simple as:
|
|
|
|
$ ./autogen.sh
|
|
$ ./configure --enable-werror
|
|
$ make
|
|
$ make check
|
|
|
|
|
|
## The CMake build system.
|
|
|
|
Although Autotools is the primary and recommended build toolchain, experimental
|
|
CMake meta build generator is also available. The build process with CMake takes
|
|
place in two stages. First, standard build files are created from configuration
|
|
scripts. Then the platform's native build tools are used for the actual
|
|
building. CMake can produce Microsoft Visual Studio project and solution files,
|
|
Unix Makefiles, Xcode projects and [many more](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html).
|
|
|
|
### Requirements
|
|
|
|
1. C99-compliant compiler toolchain (tested with GCC, Clang and Visual
|
|
Studio 2015)
|
|
2. CMake 3.1.3 or newer
|
|
|
|
There are some recommended packages to enable all features of libsndfile:
|
|
|
|
1. Ogg, Vorbis and FLAC libraries and headers to enable these formats support
|
|
2. ALSA development package under Linux to build sndfile-play utility
|
|
3. Sndio development package under BSD to build sndfile-play utility
|
|
|
|
### Building from command line
|
|
|
|
CMake can handle out-of-place builds, enabling several builds from
|
|
the same source tree, and cross-compilation. The ability to build a directory
|
|
tree outside the source tree is a key feature, ensuring that if a build
|
|
directory is removed, the source files remain unaffected.
|
|
|
|
mkdir CMakeBuild
|
|
cd CMakeBuild
|
|
|
|
Then run `cmake` command with directory where CMakeLists.txt script is located
|
|
as argument (relative paths are supported):
|
|
|
|
cmake ..
|
|
|
|
This command will configure and write build script or solution to CMakeBuild
|
|
directory. CMake is smart enough to create Unix makefiles under Linux or Visual
|
|
Studio solution if you have Visual Studio installed, but you can configure
|
|
[generator](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html)
|
|
with `-G` command line parameter:
|
|
|
|
cmake .. -G"Unix Makefiles"
|
|
|
|
The build procedure depends on the selected generator. With "Unix Makefiles" you
|
|
can type:
|
|
|
|
make & make install
|
|
|
|
With "Visual Studio" and some other generators you can open solution or project
|
|
from `CMakeBuild` directory and build using IDE.
|
|
|
|
Finally, you can use unified command:
|
|
|
|
cmake --build .
|
|
|
|
CMake also provides Qt-based cross platform GUI, cmake-gui. Using it is trivial
|
|
and does not require detailed explanations.
|
|
|
|
### Configuring CMake
|
|
|
|
You can pass additional options with `/D<parameter>=<value>` when you run
|
|
`cmake` command. Some useful system options:
|
|
|
|
* `CMAKE_C_FLAGS` - additional C compiler flags
|
|
* `CMAKE_BUILD_TYPE` - configuration type, `DEBUG`, `RELEASE`, `RELWITHDEBINFO`
|
|
or `MINSIZEREL`. `DEBUG` is default
|
|
* `CMAKE_INSTALL_PREFIX` - build install location, the same as `--prefix` option
|
|
of `configure` script
|
|
|
|
Useful libsndfile options:
|
|
|
|
* `BUILD_SHARED_LIBS` - build shared library (DLL under Windows)
|
|
* `BUILD_STATIC_LIBS` - build static library
|
|
* `BUILD_PROGRAMS` - build libsndfile's utilities from `programs/` directory
|
|
* `BUILD_EXAMPLES` - build examples
|
|
* `BUILD_TESTING` - build tests. Then you can run tests with `ctest` command
|
|
* `DISABLE_EXTERNAL_LIBS` - disable Ogg, Vorbis and FLAC support
|
|
* `DISABLE_CPU_CLIP` - disable tricky cpu specific clipper. Don't touch it if
|
|
you are not sure.
|
|
* `ENABLE_BOW_DOCS` - enable black-on-white documentation theme
|
|
* `ENABLE_EXPERIMENTAL` - enable experimental code. Don't use it if you are
|
|
not sure
|
|
* `ENABLE_CPACK` - enable [CPack](https://cmake.org/cmake/help/latest/module/CPack.html) support
|
|
* `ENABLE_PACKAGE_CONFIG` - Generate and install [package config file](https://cmake.org/cmake/help/latest/manual/cmake-packages.7.html#config-file-packages).
|
|
* `ENABLE_STATIC_RUNTIME` - enable static runtime, useful for Windows
|
|
|
|
### Notes for Windows users
|
|
|
|
First advice - set `ENABLE_STATIC_RUNTIME` to ON. This will remove dependencies
|
|
on runtime DLLs.
|
|
|
|
Second advice is about Ogg, Vorbis and FLAC support. Searching external
|
|
libraries under Windows is a little bit tricky. The best wayis to use
|
|
[Vcpkg](https://github.com/Microsoft/vcpkg). You need to install static libogg,
|
|
libvorbis and libflac libraries:
|
|
|
|
vcpkg install libogg:x64-windows-static libvorbis:x64-windows-static
|
|
libflac:x64-windows-static libogg:x86-windows-static
|
|
libvorbis:x86-windows-static libflac:x86-windows-static
|
|
|
|
Then and add this parameter to cmake command line:
|
|
|
|
-DCMAKE_TOOLCHAIN_FILE=<path-to-vcpkg>/scripts/buildsystems/vcpkg.cmake
|
|
|
|
You also need to set `VCPKG_TARGET_TRIPLET` because you use static libraries:
|
|
|
|
-DVCPKG_TARGET_TRIPLET=x64-windows-static
|
|
|
|
## Submitting Patches.
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
|
|
|
|
|
|
|
|
|
|
[brew]: http://brew.sh/
|
|
[github]: https://github.com/erikd/libsndfile/
|
|
[BuildingForAndroid]: https://github.com/erikd/libsndfile/blob/master/Building-for-Android.md
|