X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fscripting%2Fplayer.hpp;h=80e04cefdab681a419a4784e64d7f82bdc0c6db4;hb=0b73428a8a9e9563cb196e4b13167de3ec5f6b02;hp=34a6d1f7e3272fe2d81e79578bdfe8fb43f9d2a6;hpb=ed51c9c974fe748420844158b8ce572a1f8ea284;p=supertux.git diff --git a/src/scripting/player.hpp b/src/scripting/player.hpp index 34a6d1f7e..80e04cefd 100644 --- a/src/scripting/player.hpp +++ b/src/scripting/player.hpp @@ -1,12 +1,10 @@ -// $Id$ -// // SuperTux // Copyright (C) 2006 Matthias Braun // -// This program is free software; you can redistribute it and/or -// modify it under the terms of the GNU General Public License -// as published by the Free Software Foundation; either version 2 -// of the License, or (at your option) any later version. +// This program is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -14,14 +12,16 @@ // GNU General Public License for more details. // // 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +// along with this program. If not, see . -#ifndef __SCRIPTING_PLAYER_H__ -#define __SCRIPTING_PLAYER_H__ +#ifndef HEADER_SUPERTUX_SCRIPTING_PLAYER_HPP +#define HEADER_SUPERTUX_SCRIPTING_PLAYER_HPP -namespace Scripting -{ +#ifndef SCRIPTING_API +#include +#endif + +namespace scripting { class Player { @@ -35,21 +35,21 @@ public: * Set tux bonus. * This can be "grow", "fireflower" or "iceflower" at the moment */ - virtual void add_bonus(const std::string& bonus) = 0; + virtual bool add_bonus(const std::string& bonus) = 0; /** * Give tux more coins */ virtual void add_coins(int count) = 0; /** - * Make tux invicible for a short amount of time + * Make tux invincible for a short amount of time */ virtual void make_invincible() = 0; /** - * Deactivate user input for Tux + * Deactivate user/scripting input for Tux */ virtual void deactivate() = 0; /** - * Give control back to user + * Give control back to user/scripting */ virtual void activate() = 0; /** @@ -57,12 +57,12 @@ public: */ virtual void walk(float speed) = 0; /** - * Set player visible or not visible + * Set player visible or invisible */ virtual void set_visible(bool visible) = 0; /** * returns true if the player is currently visible (that is he was not set - * inivisible by the set_visible method) + * invisible by the set_visible method) */ virtual bool get_visible() = 0; @@ -73,7 +73,7 @@ public: virtual void kill(bool completely) = 0; /** - * Switches ghost mode on/off. + * Switches ghost mode on/off. * Lets Tux float around and through solid objects. */ virtual void set_ghost_mode(bool enable) = 0; @@ -83,9 +83,53 @@ public: */ virtual bool get_ghost_mode() = 0; + /** + * play cheer animation. + * This might need some space and behave in an unpredictable way. Best to use this at level end. + */ + virtual void do_cheer() = 0; + + /** + * duck down if possible. + * this won't last long as long as input is enabled. + */ + virtual void do_duck() = 0; + + /** + * stand back up if possible. + */ + virtual void do_standup() = 0; + + /** + * do a backflip if possible. + */ + virtual void do_backflip() = 0; + + /** + * jump in the air if possible + * sensible values for yspeed are negative - unless we want to jump into the ground of course + */ + virtual void do_jump(float yspeed) = 0; + + /** + * Orders the current GameSession to start a sequence + */ + virtual void trigger_sequence(std::string sequence_name) = 0; + + /** + * Uses a scriptable controller for all user input (or restores controls) + */ + virtual void use_scripting_controller(bool use_or_release) = 0; + + /** + * Instructs the scriptable controller to press or release a button + */ + virtual void do_scripting_controller(std::string control, bool pressed) = 0; + }; } #endif +/* EOF */