src/object/player.hpp

   1 //  SuperTux
   2 //  Copyright (C) 2006 Matthias Braun <matze@braunis.de>
   3 //
   4 //  This program is free software: you can redistribute it and/or modify
   5 //  it under the terms of the GNU General Public License as published by
   6 //  the Free Software Foundation, either version 3 of the License, or
   7 //  (at your option) any later version.
   8 //
   9 //  This program is distributed in the hope that it will be useful,
  10 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 //  GNU General Public License for more details.
  13 //
  14 //  You should have received a copy of the GNU General Public License
  15 //  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 #ifndef HEADER_SUPERTUX_OBJECT_PLAYER_HPP
  18 #define HEADER_SUPERTUX_OBJECT_PLAYER_HPP
  19
  20 #include "scripting/player.hpp"
  21 #include "sprite/sprite_ptr.hpp"
  22 #include "supertux/direction.hpp"
  23 #include "supertux/moving_object.hpp"
  24 #include "supertux/physic.hpp"
  25 #include "supertux/player_status.hpp"
  26 #include "supertux/script_interface.hpp"
  27 #include "supertux/timer.hpp"
  28
  29 class BadGuy;
  30 class Portable;
  31 class Climbable;
  32 class Controller;
  33 class CodeController;
  34 class Surface;
  35 class Timer;
  36
  37 /* Times: */
  38 static const float TUX_SAFE_TIME = 1.8f;
  39 static const float TUX_INVINCIBLE_TIME = 14.0f;
  40 static const float TUX_INVINCIBLE_TIME_WARNING = 2.0f;
  41 static const float GROWING_TIME = 0.35f;
  42 static const int GROWING_FRAMES = 7;
  43 static const float TUX_BACKFLIP_TIME = 2.1f; // minimum air time that backflip results in a loss of control
  44
  45 class Camera;
  46 class PlayerStatus;
  47
  48 class Player : public MovingObject,
  49                public scripting::Player,
  50                public ScriptInterface
  51 {
  52 public:
  53   enum FallMode { ON_GROUND, JUMPING, TRAMPOLINE_JUMP, FALLING };
  54   //Tux can only go this fast. If set to 0 no special limit is used, only the default limits.
  55   void set_speedlimit(float newlimit);
  56   float get_speedlimit();
  57
  58 public:
  59   Player(PlayerStatus* player_status, const std::string& name);
  60   virtual ~Player();
  61
  62   virtual void expose(HSQUIRRELVM vm, SQInteger table_idx);
  63   virtual void unexpose(HSQUIRRELVM vm, SQInteger table_idx);
  64
  65   void set_controller(Controller* controller);
  66   /*
  67    * Level solved. Don't kill Tux any more.
  68    */
  69   void set_winning();
  70   bool is_winning()
  71   {
  72     return winning;
  73   }
  74
  75   Controller* get_controller()
  76   {
  77     return controller;
  78   }
  79
  80   void use_scripting_controller(bool use_or_release);
  81   void do_scripting_controller(std::string control, bool pressed);
  82
  83   virtual void update(float elapsed_time);
  84   virtual void draw(DrawingContext& context);
  85   virtual void collision_solid(const CollisionHit& hit);
  86   virtual HitResponse collision(GameObject& other, const CollisionHit& hit);
  87   virtual void collision_tile(uint32_t tile_attributes);
  88
  89   void make_invincible();
  90   bool is_invincible() const
  91   {
  92     return invincible_timer.started();
  93   }
  94   bool is_dying() const
  95   {
  96     return dying;
  97   }
  98   Direction peeking_direction_x() const
  99   {
 100     return peekingX;
 101   }
 102
 103   Direction peeking_direction_y() const
 104   {
 105     return peekingY;
 106   }
 107
 108   void kill(bool completely);
 109   void check_bounds();
 110   void move(const Vector& vector);
 111
 112   virtual bool add_bonus(const std::string& bonus);
 113   virtual void add_coins(int count);
 114   virtual int get_coins();
 115
 116   /**
 117    * picks up a bonus, taking care not to pick up lesser bonus items than we already have
 118    *
 119    * @returns true if the bonus has been set (or was already good enough)
 120    *          false if the bonus could not be set (for example no space for big tux)
 121    */
 122   bool add_bonus(BonusType type, bool animate = false);
 123   /**
 124    * like add_bonus, but can also downgrade the bonus items carried
 125    */
 126   bool set_bonus(BonusType type, bool animate = false);
 127
 128   PlayerStatus* get_status()
 129   {
 130     return player_status;
 131   }
 132   // set kick animation
 133   void kick();
 134
 135   /**
 136    * play cheer animation.
 137    * This might need some space and behave in an unpredictable way. Best to use this at level end.
 138    */
 139   void do_cheer();
 140
 141   /**
 142    * duck down if possible.
 143    * this won't last long as long as input is enabled.
 144    */
 145   void do_duck();
 146
 147   /**
 148    * stand back up if possible.
 149    */
 150   void do_standup();
 151
 152   /**
 153    * do a backflip if possible.
 154    */
 155   void do_backflip();
 156
 157   /**
 158    * jump in the air if possible
 159    * sensible values for yspeed are negative - unless we want to jump into the ground of course
 160    */
 161   void do_jump(float yspeed);
 162
 163   /**
 164    * Adds velocity to the player (be careful when using this)
 165    */
 166   void add_velocity(const Vector& velocity);
 167
 168   /**
 169    * Adds velocity to the player until given end speed is reached
 170    */
 171   void add_velocity(const Vector& velocity, const Vector& end_speed);
 172
 173   /**
 174    * Returns the current velocity of the player
 175    */
 176   Vector get_velocity();
 177
 178   void bounce(BadGuy& badguy);
 179
 180   bool is_dead() const
 181   { return dead; }
 182   bool is_big();
 183
 184   void set_visible(bool visible);
 185   bool get_visible();
 186
 187   bool on_ground();
 188
 189   Portable* get_grabbed_object() const
 190   {
 191     return grabbed_object;
 192   }
 193   void stop_grabbing()
 194   {
 195     grabbed_object = NULL;
 196   }
 197
 198   /**
 199    * Switches ghost mode on/off.
 200    * Lets Tux float around and through solid objects.
 201    */
 202   void set_ghost_mode(bool enable);
 203
 204   /**
 205    * Switches edit mode on/off.
 206    * In edit mode, Tux will enter ghost_mode instead of dying.
 207    */
 208   void set_edit_mode(bool enable);
 209
 210   /**
 211    * Returns whether ghost mode is currently enabled
 212    */
 213   bool get_ghost_mode() { return ghost_mode; }
 214
 215   /**
 216    * Changes height of bounding box.
 217    * Returns true if successful, false otherwise
 218    */
 219   bool adjust_height(float new_height);
 220
 221   /**
 222    * Orders the current GameSession to start a sequence
 223    */
 224   void trigger_sequence(std::string sequence_name);
 225
 226   /**
 227    * Requests that the player start climbing the given Climbable
 228    */
 229   void start_climbing(Climbable& climbable);
 230
 231   /**
 232    * Requests that the player stop climbing the given Climbable
 233    */
 234   void stop_climbing(Climbable& climbable);
 235
 236   Physic& get_physic() { return physic; }
 237
 238 private:
 239   void handle_input();
 240   void handle_input_ghost(); /**< input handling while in ghost mode */
 241   void handle_input_climbing(); /**< input handling while climbing */
 242
 243   void init();
 244
 245   void handle_horizontal_input();
 246   void handle_vertical_input();
 247
 248   void activate();
 249   void deactivate();
 250   void walk(float speed);
 251   void set_dir(bool right);
 252
 253   void do_jump_apex();
 254   void early_jump_apex();
 255
 256   /**
 257    * slows Tux down a little, based on where he's standing
 258    */
 259   void apply_friction();
 260
 261 private:
 262   bool deactivated;
 263
 264   Controller* controller;
 265   std::unique_ptr<CodeController> scripting_controller; /**< This controller is used when the Player is controlled via scripting */
 266   PlayerStatus* player_status;
 267   bool duck;
 268   bool dead;
 269
 270 private:
 271   bool dying;
 272   bool winning;
 273   bool backflipping;
 274   int  backflip_direction;
 275   Direction peekingX;
 276   Direction peekingY;
 277   float glide_time;
 278   bool stone;
 279   bool swimming;
 280   float speedlimit;
 281   Controller* scripting_controller_old; /**< Saves the old controller while the scripting_controller is used */
 282   bool jump_early_apex;
 283   bool on_ice;
 284   bool ice_this_frame;
 285   SpritePtr lightsprite;
 286
 287 public:
 288   Direction dir;
 289   Direction old_dir;
 290
 291   float last_ground_y;
 292   FallMode fall_mode;
 293
 294   bool on_ground_flag;
 295   bool jumping;
 296   bool can_jump;
 297   Timer jump_button_timer; /**< started when player presses the jump button; runs until Tux jumps or JUMP_GRACE_TIME runs out */
 298   bool wants_buttjump;
 299   bool does_buttjump;
 300
 301   Timer invincible_timer;
 302   Timer skidding_timer;
 303   Timer safe_timer;
 304   Timer kick_timer;
 305   Timer shooting_timer;   // used to show the arm when Tux is shooting
 306   Timer ability_timer;  // maximum lengh of time that special abilities can last
 307   Timer cooldown_timer; // minimum time period between successive uses of a special ability
 308   Timer dying_timer;
 309   bool growing;
 310   Timer backflip_timer;
 311
 312   Physic physic;
 313
 314   bool visible;
 315
 316   Portable* grabbed_object;
 317
 318   SpritePtr sprite; /**< The main sprite representing Tux */
 319
 320   SurfacePtr airarrow; /**< arrow indicating Tux' position when he's above the camera */
 321
 322   Vector floor_normal;
 323   void position_grabbed_object();
 324   void try_grab();
 325
 326   bool ghost_mode; /**< indicates if Tux should float around and through solid objects */
 327   bool edit_mode; /**< indicates if Tux should switch to ghost mode rather than dying */
 328
 329   Timer unduck_hurt_timer; /**< if Tux wants to stand up again after ducking and cannot, this timer is started */
 330
 331   Timer idle_timer;
 332   unsigned int idle_stage;
 333
 334   Climbable* climbing; /**< Climbable object we are currently climbing, null if none */
 335
 336 private:
 337   Player(const Player&);
 338   Player& operator=(const Player&);
 339 };
 340
 341 #endif /*SUPERTUX_PLAYER_H*/
 342
 343 /* EOF */