Permalink
Browse files

Merge branch 'master' of http://git.rim.net/gaming/alut

  • Loading branch information...
2 parents ca27324 + 7b6652d commit 639f215d09987d0a40c7eb5d4ef1b10a152e7b29 Eduardo Pelegri-Llopart committed Oct 16, 2011
View
387 .cproject

Large diffs are not rendered by default.

Oops, something went wrong.
View
@@ -0,0 +1,8 @@
+
+/Device-Debug
+/Device-Profile
+/Device-Release
+/Simulator
+/Simulator-Coverage
+/Simulator-Profile
+/Device-Coverage
View
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+ <name>alut</name>
+ <comment></comment>
+ <projects>
+ </projects>
+ <buildSpec>
+ <buildCommand>
+ <name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
+ <triggers>clean,full,incremental,</triggers>
+ <arguments>
+ <dictionary>
+ <key>?name?</key>
+ <value></value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.append_environment</key>
+ <value>true</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.buildArguments</key>
+ <value></value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.buildCommand</key>
+ <value>make</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.buildLocation</key>
+ <value>${workspace_loc:/alut/Device-Debug}</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.contents</key>
+ <value>org.eclipse.cdt.make.core.activeConfigSettings</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.enableAutoBuild</key>
+ <value>false</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.enableCleanBuild</key>
+ <value>true</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.enableFullBuild</key>
+ <value>true</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.stopOnError</key>
+ <value>true</value>
+ </dictionary>
+ <dictionary>
+ <key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
+ <value>true</value>
+ </dictionary>
+ </arguments>
+ </buildCommand>
+ <buildCommand>
+ <name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
+ <triggers>full,incremental,</triggers>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ <buildCommand>
+ <name>com.qnx.tools.bbt.xml.core.bbtXMLValidationBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ </buildSpec>
+ <natures>
+ <nature>org.eclipse.cdt.core.cnature</nature>
+ <nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
+ <nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
+ <nature>com.qnx.tools.ide.bbt.core.bbtnature</nature>
+ <nature>org.eclipse.cdt.core.ccnature</nature>
+ </natures>
+</projectDescription>
View
203 README
@@ -0,0 +1,203 @@
+The freealut library
+=====================
+
+freealut is a free implementation of OpenAL's ALUT standard. See the file
+AUTHORS for the people involved.
+
+
+Building and installing on *nix-alikes using autotools
+======================================================
+
+To build and run ALUT, you need an OpenAL somewhere (and a sound card, of course
+:-). If OpenAL is not installed in a standard place (let's say ${OPENAL_PREFIX})
+you'll have to tell the build system about it:
+
+ CPPFLAGS="-I${OPENAL_PREFIX}/include"
+ LDFLAGS="-L${OPENAL_PREFIX}/lib"
+ export CPPFLAGS LDFLAGS
+
+If you install ALUT from the CVS repository, you'll have to call
+
+ ./autogen.sh
+
+first, this will generate some necessary files for building ALUT.
+
+If these initial preparations are done, you can simply run:
+
+ ./configure
+ make
+ make install
+
+The last step is optional and must be done as 'root', you can build and use the
+test programs in 'test_suite' and the example programs in 'examples' without
+installing ALUT. To build these, just go to the respective subdirectories and
+run 'make'.
+
+Alternatively, there is a spec file in the admin/RPM subdirectory, which can be
+used to build an RPM.
+
+
+Building with VisualStudio
+==========================
+
+The admin subdirectory contains VisualStudio6 and VisualStudioDotNET
+subdirectories, which contain a Visual Studio 6 workspace and a Visual Studio
+.NET solution, respectively. These expect the OpenAL SDK (header and import
+library) at the standard path "C:\Program Files\OpenAL 1.1 with EFX SDK". If
+this is not the case for your setup, you can change this either directly with a
+text editor in the project files (the only way for *real* men ;-) or via the
+project settings within Visual Studio. When everything is OK, just build
+e.g. the hello_world project and you should get the ALUT library itself and a
+demo with Steve Baker saying an immortal phrase.
+
+
+Building with CMake
+===================
+
+The CMake build files are maintained by prakash@punnoor.de, so
+if you have troubles building Alut using CMake, please contact
+me and not the Alut devs, as the official build system is still
+the one using autotools. The CMake build files are currenty
+meant as an additional possibility to build Alut.
+
+The aim of using CMake is making portable development easier, as
+CMake containg generators for various build systems. On eg. Unix
+Makefiles will be built, and on Windows MS VC++ project files, if
+you wish. You can get CMake at cmake.org.
+
+Current status:
+The build system is feature complete, so it (should) build every-
+thing as the default one does.
+
+
+This document explains briefly how to build with CMake on Linux via out-
+of-tree build:
+
+- Change to the alut dir.
+- Create a dir, eg "default", and change into it.
+- Now (eg.) run:
+
+cmake .. -DCMAKE_INSTALL_PREFIX:STRING="/usr" -DCMAKE_C_FLAGS:STRING="-march=athlon-xp -O2"
+make
+make install
+
+ If you exported your CFLAGS, there is no need to specify them
+ explicitly, as CMake will pick them up.
+
+- OpenAL should get installed as you got used to it.
+
+
+I really would like to get CMake building Alut on every
+supported platform. So please contact me if it doesn't build
+on yours. I'll try to fix this with your help.
+
+
+Some Tips:
+
+- You can use a console GUI named ccmake for configuring cmake.
+ This also comes in handy, to find out about available options.
+ You can also set options via command-line:
+
+ccmake .. -DCMAKE_INSTALL_PREFIX:STRING="/usr" -DCMAKE_C_FLAGS:STRING="-march=athlon-xp -O2"
+
+ sets the two variables defined on command line and then starts
+ the GUI. Press 'c' the first time and every time you want to commit
+ changes in the config. Finally press 'g' to run the generator.
+ Btw, to set boolean vars from the command line, use -DVAR:BOOL=X,
+ where X is eg. ON or OFF.
+
+- If you want more output at compile time, use
+
+make VERBOSE=1
+
+- If you want to install to a different directory (using same prefix),
+ use
+
+make install DESTDIR=/foo/bar
+
+- CMake doesn't has a distclean target by default, so you better
+ really do an out-of-tree build, then you can simply delete its
+ content when you want a distclean... Furthermore it is easier to
+ have different builds using different parameters via out-of-tree
+ builds.
+
+- If you are interested in variables to set, take a look into
+ CMakeCache.txt after having run the configuring stage.
+
+- If you update your source tree via cvs and want to rebuild an pre-
+ viously built lib without cleaning, you better at least clear the
+ CMake cache (remove CMakeCache.txt) otherwise a modified CMake project
+ file could result to unwanted behaviour.
+
+
+Building for QNX from Windows
+==================================
+Run cmd.exe and execute the following commands:
+> cd [bbndk] where [bbndk] is where the QNX NDK was installed (i.e. C:\bbndk)
+> NativeSDK-env.bat
+> cd [alut]/qnx where [alut] is the directory where ALUT was extracted to
+> make
+Following this, the relevant binaries should reside in the following subdirectories:
+ libalut:
+ [alut]/qnx/arm/a.le.v7 (ARM release)
+ [alut]/qnx/arm/a.le.v7.g (ARM debug)
+ [alut]/qnx/x86/a (x86 simulator release)
+ [alut]/qnx/x86/a.g (x86 simulator debug)
+
+
+Support
+=======
+
+Please don't email me the authors directly, sign up to the OpenAL user's mailing
+list. Instructions can be found here:
+
+ http://www.openal.org/
+
+
+Licensing
+=========
+
+These libraries are offered as OpenSource freeware under the provisions of the
+GNU Library Public License (LGPL). Those terms and conditions are detailed in
+the file 'COPYING' in this directory.
+
+
+Portability and Dependencies
+============================
+
+This library is designed to be easily portable (and more importantly so that
+programs using it can be UTTERLY portable).
+
+
+Compiling/Linking with ALUT
+===========================
+
+In your source code, simply add:
+
+ #include <AL/alut.h>
+
+On *nix-alikes, use
+
+ openal-config --cflags
+ openal-config --libs
+
+to find out the compiler and linker flags needed for OpenAL, the flags needed
+for ALUT itself depend on the --prefix option given to configure.
+
+In a VisualStudio project, add the path to the ALUT header, import library and
+DLL to your project settings as usual.
+
+
+Directories
+===========
+
+Within this distribution, you will find the following directories:
+
+admin -- Administrative files needed for building ALUT
+doc -- The ALUT documentation
+examples -- For application authors, here is a small collection of example
+ programs that you can use to get you started
+include -- The ALUT header
+src -- The source code for the ALUT library itself
+test_suite -- A small suite of test programs to check that ALUT is installed and
+ working correctly
Oops, something went wrong.

0 comments on commit 639f215

Please sign in to comment.