//
// 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
#include STL_STRING
+#include <simgear/debug/logstream.hxx>
+
+#include <plib/sg.h>
+
#if defined(__APPLE__)
# define AL_ILLEGAL_ENUM AL_INVALID_ENUM
# define AL_ILLEGAL_COMMAND AL_INVALID_OPERATION
# include <AL/alut.h>
#endif
-#include <simgear/debug/logstream.hxx>
-
SG_USING_STD(string);
-
/**
* manages everything we need to know for an individual sound sample
*/
// 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];
double pitch;
double volume;
+ double reference_dist;
+ double max_dist;
ALboolean loop;
+
public:
/**
later.)
*/
SGSoundSample( const char *path, const char *file, bool cleanup );
- SGSoundSample( unsigned char *_data, int len, int _freq );
+
+ /**
+ * Constructor.
+ * @param _data Pointer to a memory buffer containing the sample data
+ * @param len Byte length of array
+ * @param _freq Frequency of the provided data (bytes per second)
+ * @param cleanup Request clean up the intermediate data (this
+ should usually be true unless you want to manipulate the data
+ later.)
+ */
+ SGSoundSample( unsigned char *_data, int len, int _freq, bool cleanup );
+
~SGSoundSample();
/**
source_pos[0] = pos[0];
source_pos[1] = pos[1];
source_pos[2] = pos[2];
- alSourcefv( source, AL_POSITION, source_pos );
+
+ sgVec3 final_pos;
+ sgAddVec3( final_pos, source_pos, offset_pos );
+
+ alSourcefv( source, AL_POSITION, final_pos );
+ }
+
+ /**
+ * Set "constant" offset position of sound source (uses same
+ * coordinate system as opengl)
+ */
+ inline void set_offset_pos( ALfloat *pos ) {
+ offset_pos[0] = pos[0];
+ offset_pos[1] = pos[1];
+ offset_pos[2] = pos[2];
+
+ sgVec3 final_pos;
+ sgAddVec3( final_pos, source_pos, offset_pos );
+
+ alSourcefv( source, AL_POSITION, final_pos );
+ }
+
+ /**
+ * Set the orientation of the sound source, both for direction
+ * and audio cut-off angles.
+ */
+ inline void set_orientation( ALfloat *dir, ALfloat inner_angle=360.0,
+ ALfloat outer_angle=360.0,
+ ALfloat outer_gain=0.0)
+ {
+ inner = inner_angle;
+ outer = outer_angle;
+ outergain = outer_gain;
+ alSourcefv( source, AL_DIRECTION, dir);
+ alSourcef( source, AL_CONE_INNER_ANGLE, inner );
+ alSourcef( source, AL_CONE_OUTER_ANGLE, outer );
+ alSourcef( source, AL_CONE_OUTER_GAIN, outergain );
}
/**
alSourcefv( source, AL_VELOCITY, source_vel );
}
+
+ /**
+ * Set reference distance of sound (the distance where the gain
+ * will be half.)
+ */
+ inline void set_reference_dist( ALfloat dist ) {
+ reference_dist = dist;
+ alSourcef( source, AL_REFERENCE_DISTANCE, reference_dist );
+ }
+
+
+ /**
+ * Set maximume distance of sound (the distance where the sound is
+ * no longer audible.
+ */
+ inline void set_max_dist( ALfloat dist ) {
+ max_dist = dist;
+ alSourcef( source, AL_MAX_DISTANCE, max_dist );
+ }
};