ALURE

AL Utilities REtooled

Contents:

Overview
About
Release
Download
Installing

Overview

ALURE is a utility library to help manage common tasks with OpenAL applications. This includes device enumeration and initialization, file loading, and streaming. As of version 1.1, it is X11/MIT licensed, allowing it to be used in open- and closed-source programs, freeware or commercial.

About This Project

The purpose of this library is to provide pre-made functionality that would otherwise be repetitive or difficult to (re)code for various projects and platforms, such as loading a sound file into an OpenAL buffer and streaming an audio file through a buffer queue. Support for different formats is consistant across platforms, so no special checks are needed when loading files, and all formats are handled through the same API.

Currently ALURE includes a basic .wav and .aif file reader, and can leverage external libraries such as libSndFile (for extended wave formats and several others), VorbisFile (for Ogg Vorbis), FLAC (for FLAC and Ogg FLAC), and others. External libraries can also be dynamically loaded at run-time, or individually disabled outright at compile time.

ALURE 1.2 is now available!

Changes from 1.1 include:

Fixed potential lockup when the library is shutdown with streams open.
Added ALURE_VERSION* macros to detect the version being compiled with.
Introduced alureGetStreamLength to get the approximate number of samples in a stream, if known.
Not all codecs can accurately supply this information, if at all (the sndfile, vorbisfile, FLAC, and wav/aiff codecs will attempt to get it).
The vorbisfile codec now works with libvorbisidec, for Tremor support.
Improved detection for OpenAL and some support libs during compilation.
Compilation now uses a version script on non-Windows, non-Apple systems to better control the exported functions.
Made alureSetStreamPatchset more efficient when the default IO functions are in use.
The play and stream examples are now installed by default, but can be disabled with the BUILD_EXAMPLES and INSTALL_EXAMPLES options to cmake.

Download

Building ALURE needs CMake version 2.4 or newer (older versions may possibly work as well, but are untested). Autotools is not supported.

ALURE is provided as a source tarball and MinGW-compatible Win32 binaries, both dynamic and static using dynamic loading (note for MSVC users: the provided DLL should work for apps compiled with MSVC, however there is no import lib; contributions for an import lib are welcome).
alure-1.2.tar.bz2 (gzip version)
alure-1.2-win32-bin.zip

Online documentation can be found here.

A more up-to-date GIT repository is available at repo.or.cz. You can get it by running:
git clone git://repo.or.cz/alure.git alure
Note that you need to install GIT to download it.

Source Install

To install ALURE, first extract it. It will automatically extract itself into the alure-<version>/ directory. Using your favorite shell, go into the build/ directory, and run:
cmake ..
Assuming configuration went well, you can then build it, typically using GNU Make.

Click here to go back.