Utilities » Magnum OpenAL Info

Displays information about Magnum OpenAL capabilities.

This utility is built if MAGNUM_WITH_AL_INFO is enabled when building Magnum. To use this utility with CMake, you need to request the al-info component of the Magnum package and use the Magnum::al-info target for example in a custom command:

find_package(Magnum REQUIRED al-info)

add_custom_command(OUTPUT ... COMMAND Magnum::al-info ...)

See Downloading and building, Usage with CMake and the Audio namespace for more information.

Usage

magnum-al-info [--magnum-...] [-h|--help] [-s|--short] [--extension-strings]
    [--frequency Hz] [--hrtf true|false] [--mono-source-count N]
    [--stereo-source-count N] [--refresh-rate Hz]

Arguments:

  • -h,--help — display this help message and exit
  • -s, --short — display just essential info and exit
  • --extension-strings — list all extension strings provided by the driver (implies --short)
  • --frequency Hz — override OpenAL context frequency (default: -1)
  • --hrtf true|false — override OpenAL HRTF configuration
  • --mono-source-count N — override OpenAL mono source count (default: -1)
  • --stereo-source-count N — override OpenAL stereo source count (default: -1)
  • --refresh-rate Hz — override OpenAL refresh rate (default: -1)
  • --magnum-... — engine-specific options (see Command-line options for details)

Usage on Emscripten

When installing Magnum, point the MAGNUM_DEPLOY_PREFIX CMake variable to your webserver location. The Magnum Info utility is then available in a magnum-al-info/ subdirectory of given location. You can pass all command-line arguments from above to it via GET parameters. See the relevant section of the Emscripten guide for more information.

Example output

  +---------------------------------------------------------+
  |   Information about Magnum engine OpenAL capabilities   |
  +---------------------------------------------------------+

Audio renderer: OpenAL Soft by OpenAL Community
OpenAL version: 1.1 ALSOFT 1.23.1
Available devices:
    OpenAL Soft
Current device: OpenAL Soft

Frequency: 44100 Hz
HRTF: Audio::Context::HrtfStatus::Disabled
Mono source count: 255
Stereo source count: 1
Refresh rate: 50 Hz

Vendor extension support:
    ALC_ENUMERATION_EXT                                           SUPPORTED
    ALC_SOFTX_HRTF                                                   -
    ALC_SOFT_HRTF                                                 SUPPORTED
    AL_EXT_ALAW                                                   SUPPORTED
    ...