//
// Written by Curtis Olson, started April 2004.
//
-// Copyright (C) 2004 Curtis L. Olson - curt@flightgear.org
+// Copyright (C) 2004 Curtis L. Olson - http://www.flightgear.org/~curt
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
-// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
//
// $Id$
#include <simgear/compiler.h>
-#include <AL/al.h>
+#include <string>
#include <simgear/debug/logstream.hxx>
+#include <simgear/structure/SGReferenced.hxx>
+#include <simgear/structure/SGSharedPtr.hxx>
+
+#include <plib/sg.h>
+
+#if defined(__APPLE__)
+# define AL_ILLEGAL_ENUM AL_INVALID_ENUM
+# define AL_ILLEGAL_COMMAND AL_INVALID_OPERATION
+# include <OpenAL/al.h>
+# include <OpenAL/alut.h>
+#else
+# include <AL/al.h>
+# include <AL/alut.h>
+#endif
+
+#ifndef HAVE_WINDOWS_H
+ #ifdef AL_VERSION_1_2
+ #define USE_OPEN_AL_DOPPLER should work
+ #else
+ #define USE_OPEN_AL_DOPPLER_WITH_FIXED_LISTENER better than nothing
+ #endif
+#else
+ // the Open_AL Doppler calculation seems to be buggy on windows
+ #define USE_SOFTWARE_DOPPLER seem to be necessary
+#endif
+using std::string;
/**
* manages everything we need to know for an individual sound sample
*/
-class SGSoundSample {
+class SGSoundSample : public SGReferenced {
private:
+ string sample_name;
+
// Buffers hold sound data.
ALuint buffer;
// Position of the source sound.
ALfloat source_pos[3];
+ // A constant offset to be applied to the final source_pos
+ ALfloat offset_pos[3];
+
+ // The orientation of the sound (direction and cut-off angles)
+ ALfloat direction[3];
+ ALfloat inner, outer, outergain;
+
// Velocity of the source sound.
ALfloat source_vel[3];
// configuration values
ALenum format;
ALsizei size;
- ALvoid* data;
ALsizei freq;
double pitch;
double volume;
+#ifdef USE_SOFTWARE_DOPPLER
+ double doppler_pitch_factor;
+ double doppler_volume_factor;
+#endif
+ double reference_dist;
+ double max_dist;
ALboolean loop;
+ bool playing;
+ bool bind_source();
+ bool no_Doppler_effect;
+
public:
- SGSoundSample( const char *path, const char *file );
- SGSoundSample( unsigned char *_data, int len, int _freq );
+ /**
+ * Empty constructor, can be used to read data to the systems
+ * memory and not to the driver.
+ */
+ SGSoundSample();
+
+ /**
+ * Constructor
+ * @param path Path name to sound
+ * @param file File name of sound
+ should usually be true unless you want to manipulate the data
+ later.)
+ */
+ SGSoundSample( const char *path, const char *file, bool no_Doppler_effect = true );
+
+ /**
+ * Constructor.
+ * @param _data Pointer to a memory buffer containing the sample data
+ the application is responsible for freeing the buffer data.
+ * @param len Byte length of array
+ * @param _freq Frequency of the provided data (bytes per second)
+ should usually be true unless you want to manipulate the data
+ later.)
+ */
+ SGSoundSample( unsigned char *_data, int len, int _freq, bool no_Doppler_effect = true );
+
~SGSoundSample();
/**
* Start playing this sample.
*
- * @param looped Define wether the sound should be played in a loop.
+ * @param _loop Define whether the sound should be played in a loop.
*/
void play( bool _loop );
inline void play_looped() { play(true); }
/**
- * Test if a sample is curretnly playing.
+ * Test if a sample is currently playing.
* @return true if is is playing, false otherwise.
*/
- inline bool is_playing( ) {
- ALint result;
- alGetSourcei( source, AL_SOURCE_STATE, &result );
- if ( alGetError() != AL_NO_ERROR) {
- SG_LOG( SG_GENERAL, SG_ALERT,
- "Oops AL error in sample is_playing()!" );
- }
- return (result == AL_PLAYING) ;
- }
+ bool is_playing( );
/**
* Get the current pitch setting of this sample.
/**
* Set the pitch of this sample.
*/
- inline void set_pitch( double p ) {
- // clamp in the range of 0.01 to 2.0
- if ( p < 0.01 ) { p = 0.01; }
- if ( p > 2.0 ) { p = 2.0; }
- pitch = p;
- alSourcef( source, AL_PITCH, pitch );
- if ( alGetError() != AL_NO_ERROR) {
- SG_LOG( SG_GENERAL, SG_ALERT,
- "Oops AL error in sample set_pitch()! " << p );
- }
- }
+ void set_pitch( double p );
/**
* Get the current volume setting of this sample.
/**
* Set the volume of this sample.
*/
- inline void set_volume( double v ) {
- volume = v;
- alSourcef( source, AL_GAIN, volume );
- if ( alGetError() != AL_NO_ERROR) {
- SG_LOG( SG_GENERAL, SG_ALERT,
- "Oops AL error in sample set_volume()!" );
- }
- }
+ void set_volume( double v );
/**
* Returns the size of the sounds sample
}
/**
- * Return a pointer to the raw data
+ * Set position of sound source (uses same coordinate system as opengl)
*/
- inline char *get_data() {
- return (char *)data;
- }
+ void set_source_pos( ALfloat *pos );
+
+ /**
+ * Set "constant" offset position of sound source (uses same
+ * coordinate system as opengl)
+ */
+ void set_offset_pos( ALfloat *pos );
+
+ /**
+ * Set the orientation of the sound source, both for direction
+ * and audio cut-off angles.
+ */
+ void set_orientation( ALfloat *dir, ALfloat inner_angle=360.0,
+ ALfloat outer_angle=360.0,
+ ALfloat outer_gain=0.0);
+
+ /**
+ * Set velocity of sound source (uses same coordinate system as opengl)
+ */
+ void set_source_vel( ALfloat *vel, ALfloat *listener_vel );
+
+
+ /**
+ * Set reference distance of sound (the distance where the gain
+ * will be half.)
+ */
+ void set_reference_dist( ALfloat dist );
+
+
+ /**
+ * Set maximum distance of sound (the distance where the sound is
+ * no longer audible.
+ */
+ void set_max_dist( ALfloat dist );
+
+ /**
+ * Load a sound file into a memory buffer only.
+ */
+ ALvoid* load_file(const char *path, const char *file);
};
projects / simgear.git / blobdiff