---

SoundMgr.H

Go to the documentation of this file.

#ifndef SOUNDMGR_H
#define SOUNDMGR_H

#define OUTSIDE_GLUE_CORE
#include <mlib/points.H>
#include <std/strings.H>
#include <std/list.H>


// types of parameters that can be set for each sound
enum SOUNDPARAM {
  SP_LOOP = 0,    // 0.0 or 1.0
  SP_PITCH = 1,   // (0.0,1.0] default=1.0
  SP_GAIN = 2,    // [0.0,any] default=1.0 0.0=mute 1.0=normal
  SP_POSX = 3,    // default <0,0,0>
  SP_POSY = 4,
  SP_POSZ = 5,
  SP_VELX = 6,    // default <0,0,0>
  SP_VELY = 7,
  SP_VELZ = 8,

  SP_NUM_PARAMS = 9
};


// base class for sound device implementations
class SoundImplementation
{
public:
  // listener related
  virtual void setListenerLoc(Wtransf m) = 0;
  virtual void setListenerVel(Wvec v) =  0;
  virtual void setListenerGain(float g) = 0;

  // for each sound, accessed via filename
  virtual void load(str_ptr filename) = 0;
  virtual void play(str_ptr filename) = 0;
  virtual void stop(str_ptr filename) = 0;
  virtual void deleteSound(str_ptr filename) = 0;
  virtual void setParam(str_ptr filename, SOUNDPARAM param, float value) = 0;
};


// after adding an implementation to the SOUNDMGR, either a 
// compiled-in implementation or a network interface to a soundserver,
// make calls to SOUNDMGR within a program to deal with sounds
class SOUNDMGR
{
public:

  // add a sound device to the manager..  need to do this before
  // anything can be played!
  // examples of implementations: 
  // 1. a network interface for a sound server
  // 2. code that makes calls to a sound library like OpenAL
  static void addImplementation(SoundImplementation *simp);

  static void setListenerLoc(Wtransf m);
  static void setListenerVel(Wvec v);
  static void setListenerGain(float g);

  // load a sound into memory
  static void load(str_ptr filename);
  // play a sound, if not already loaded will try to load first
  static void play(str_ptr filename);
  // stop playing a sound
  static void stop(str_ptr filename);
  // remove a sound file from memory
  static void deleteSound(str_ptr filename);

  // sets a parameter for a sound, for example, pitch, freq, or gain.
  static void setParam(str_ptr filename, SOUNDPARAM param, float value);
  
private:

  static ARRAY<SoundImplementation*> _imp;

};

#endif

---