src/object/ambient_sound.h

   1 // ambient_sound.h   basti_
   2 //
   3 //  SuperTux
   4 //
   5 //  This program is free software; you can redistribute it and/or
   6 //  modify it under the terms of the GNU General Public License
   7 //  as published by the Free Software Foundation; either version 2
   8 //  of the License, or (at your option) any later version.
   9 //
  10 //  This program is distributed in the hope that it will be useful,
  11 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 //  GNU General Public License for more details.
  14 //
  15 //  You should have received a copy of the GNU General Public License
  16 //  along with this program; if not, write to the Free Software
  17 //  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  18 //  02111-1307, USA.
  19
  20 /**
  21  *  Ambient Sound Source, gamma version. Features:
  22  *
  23  *  - "rounded rectancle" geometry with position, dimension and
  24  *    "rounding radius" (extending in all directions) of a 100%
  25  *    volume area, adjustable maximum volume, inverse square
  26  *    falloff outside area.
  27  *
  28  *  - degenerates gracefully to a disc for dimension=0
  29  *
  30  *  - parameters:
  31  *
  32  *    x, y               position
  33  *    width, height      dimension
  34  *    distance_factor    high = steep fallofff
  35  *    distance_bias      high = big "100% disc"
  36  *    silence_distance   defaults reasonably.
  37  *    sample             sample to be played back in loop mode
  38  *
  39  *      basti_
  40  */
  41
  42 #ifndef __AMBIENT_SOUND_H__
  43 #define __AMBIENT_SOUND_H__
  44
  45 #include "game_object.h"
  46 #include "resources.h"
  47 #include "player.h"
  48 #include "SDL_mixer.h"
  49
  50 class SoundSource;
  51
  52 class AmbientSound : public GameObject
  53 {
  54 public:
  55   AmbientSound(const lisp::Lisp& lisp);
  56   AmbientSound(Vector pos, float factor, float bias, float vol, std::string file);
  57   ~AmbientSound();
  58 protected:
  59   virtual void hit(Player& player);
  60   virtual void update(float time);
  61   virtual void draw(DrawingContext&);
  62   virtual void start_playing();
  63   virtual void stop_playing();
  64 private:
  65   Vector position;
  66   Vector dimension;
  67
  68   std::string sample;
  69   SoundSource* sound_source;
  70   int latency;
  71
  72   float distance_factor;  /// distance scaling
  73   float distance_bias;    /// 100% volume disc radius
  74   float silence_distance; /// not implemented yet
  75
  76   float maximumvolume; /// maximum volume
  77   float targetvolume;  /// how loud we want to be
  78   float currentvolume; /// how loud we are
  79
  80   float * volume_ptr; /// this will be used by the volume adjustment effect.
  81 };
  82
  83 #endif
  84