OgreAL Perl bindings ==================== This distribution provides Perl bindings for the OgreAL C++ 3D audio library by Casey Borders. See http://ogreal.sourceforge.net/ or search for OgreAL on the OGRE 3D wiki http://www.ogre3d.org/wiki/index.php . OgreAL integrates the OpenAL audio library with OGRE 3D. That lets you attach a sound to a node in a 3D scene, so that the sound seems to be coming from a certain place within the scene, which could be interesting in games for example. I was going to just bundle this in with the Perl Ogre module, but putting it in a separate module allows people to download it only if they need it (Perl Ogre is getting pretty big already, as it is...) DEPENDENCIES Required: Ogre - the Perl module OgreAL - latest version from svn libopenal - latest version There are installation notes below. Optional Perl modules for the examples: OIS Ogre::BetaGUI OIS provides a way of obtaining user input. If you have another way to do that (SDL, for example), or your application doesn't accept user input, then you don't have to install OIS. Ogre::BetaGUI allows you to make a simple graphical user interface with a mouse cursor, windows, buttons, text boxes, and labels. These are required for running the examples, but otherwise it's up to you. INSTALLATION Ideally, you should be able to do this to install this Perl module, Ogre::AL. 1) install Ogre and OIS Perl modules That will include installing the corresponding C++ libraries. 2) install latest OgreAL : svn co https://ogreal.svn.sourceforge.net/svnroot/ogreal/trunk/OgreAL-Eihort cd OgreAL-Eihort/ ./bootstrap ./configure make sudo make install 3) install this module: perl Makefile.PL make make test make install As of today, with r130 from subversion, the above will not quite work. If it doesn't, there hasn't been a patch yet, then see http://www.ogre3d.org/addonforums/viewtopic.php?f=10&t=9703&p=64280#p64280 and apply this patch cp ogreal-r130.diff /tmp/ patch -p0 < /tmp/ogreal-r130.diff to the OgreAL sources before running `make`. BUGS No doubt... Please report any bugs/suggestions to . COPYRIGHT AND LICENCE Copyright 2007, 2009, Scott Lanning. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. OgreAL is copyright Casey Borders and is currently (4 Oct 2009) distributed under the LGPL license. See the OgreAL distribution for more details.