libopenmpt: Dependencies

libopenmpt 0.8.8-pre.0+r25466 cross-platform C++ and C library to decode tracked music files

Dependencies

# Dependencies

## libopenmpt

- Supported compilers for building libopenmpt:

  - Microsoft Visual Studio 2019 or higher, running on a amd64 build system (other target systems are supported)

    Please note that we do not support building with a later Visual Studio installation with an earlier compiler version. This is because, while later Visual Studio versions allow installing earlier compilers to be available via the later version's environment, in this configuration, the earlier compiler will still use the later C and C++ runtime's headers and implementation, which significantly increases the matrix of possible configurations to test.

  - Microsoft Visual Studio 2017 XP targeting toolset
  - GCC 7.1 or higher
  - Clang 6 or higher
  - MinGW-W64 7.1 (posix threading model) or higher
  - MinGW-W64 13.1 (mcfgthread threading model) or higher
  - MinGW-W64 7.1 (win32 threading model) up to MinGW-W64 13.0 (win32 threading model)
  - emscripten 3.1.51 or higher
  - DJGPP GCC 7.1 or higher

  - any other C++23, C++20, or C++17 compliant compiler

    libopenmpt makes the following assumptions about the C++ implementation used for building:

    - `std::numeric_limits<unsigned char>::digits == 8` (enforced by static_assert)
    - existence of `std::uintptr_t` (enforced by static_assert)
    - in C++23/C++20 mode, `std::endian::little != std::endian::big` (enforced by static_assert)
    - `wchar_t` encoding is either UTF-16 or UTF-32 (implicitly assumed)
    - representation of basic source character set is ASCII (implicitly assumed)
    - representation of basic source character set is identical in char and `wchar_t` (implicitly assumed)

    libopenmpt does not rely on any specific implementation defined or undefined behaviour (if it does, that's a bug in libopenmpt). In particular:

    - `char` can be `signed` or `unsigned`
    - shifting signed values is implementation defined
    - `signed` integer overflow is undefined
    - `float` and `double` can be non-IEEE754

    libopenmpt can optionally support certain incomplete C++ implementations:

    - platforms without `wchar_t` support (like DJGPP)
    - platforms without working `std::random_device` (like Emscripten when running in `AudioWorkletProcessor` context)
    - platforms without working `std::high_resolution_clock` (like Emscripten when running in `AudioWorkletProcessor` context)
- Required compilers to use libopenmpt:
  - Any C89 / C99 / C11 / C17 / C23 compatible compiler should work with the C API as long as a C99 compatible stdint.h is available.
  - Any C++23, C++20, or C++17 compatible compiler should work with the C++ API.
- J2B support requires an inflate (deflate decompression) implementation:
  - zlib (or miniz can be used internally)
- MO3 support requires:
  - libmpg123 >= 1.14.0 (or minimp3 can be used internally)
  - libogg, libvorbis, and libvorbisfile (or stb_vorbis can be used internally)
- Building on Unix-like systems requires:
  - GNU make
  - pkg-config
- The Autotools-based build system requires:
  - pkg-config 0.24 or higher
  - zlib
  - doxygen

## openmpt123

- Live sound output requires one of:
  - PulseAudio
  - SDL 2
  - PortAudio v19
  - Win32
  - liballegro 4.2 on DJGPP/DOS

# Optional dependencies

## libopenmpt

- doxygen 1.8 or higher is required to build the documentation.

## openmpt123

- Rendering to PCM files can use:
  - FLAC 1.3 or higher
  - libsndfile
  - Win32 for WAVE
  - raw PCM has no external dependencies
- help2man is required to build the documentation.

# Source packages

Building the source packages additionally requires:

- 7z (7-zip)
- autoconf
- autoconf-archive
- automake
- awk (mawk)
- git
- gzip
- help2man
- libtool
- subversion
- tar
- xpath (libxml-xpath-perl)
- zip