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 ...