X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fscripting%2Fplayer.hpp;h=a8f63b769c9d10851a19a49dc65b6f85b23ddf91;hb=c81b842f4880cd7b4958e03e983e50bff95d02ef;hp=5796524631928db06c97a5651ca921fd69608d87;hpb=61fefdd27bed4650cfb515f2511c4fb3de393193;p=supertux.git diff --git a/src/scripting/player.hpp b/src/scripting/player.hpp index 579652463..a8f63b769 100644 --- a/src/scripting/player.hpp +++ b/src/scripting/player.hpp @@ -1,8 +1,27 @@ -#ifndef __PLAYER_H__ -#define __PLAYER_H__ +// 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 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 +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// 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, see . -namespace Scripting -{ +#ifndef HEADER_SUPERTUX_SCRIPTING_PLAYER_HPP +#define HEADER_SUPERTUX_SCRIPTING_PLAYER_HPP + +#ifndef SCRIPTING_API +#include +#endif + +namespace scripting { class Player { @@ -12,31 +31,25 @@ public: {} #endif -#if 0 /** * Set tux bonus. * This can be "grow", "fireflower" or "iceflower" at the moment */ - virtual void set_bonus(const std::string& bonus) = 0; - /** - * Give tux another life - */ - virtual void add_life() = 0; + virtual bool add_bonus(const std::string& bonus) = 0; /** * Give tux more coins */ virtual void add_coins(int count) = 0; -#endif /** - * 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; /** @@ -44,17 +57,88 @@ public: */ virtual void walk(float speed) = 0; /** - * Set player visible or not visible + * Face Tux in the proper direction + */ + virtual void set_dir(bool right) = 0; + /** + * 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; + + /** + * Hurts a player, if completely=true then the player will be killed even + * if he had grow or fireflower bonus + */ + virtual void kill(bool completely) = 0; + + /** + * Switches ghost mode on/off. + * Lets Tux float around and through solid objects. + */ + virtual void set_ghost_mode(bool enable) = 0; + + /** + * Returns whether ghost mode is currently enabled + */ + virtual bool get_ghost_mode() = 0; + + /** + * start kick animation + */ + virtual void kick() = 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 */