Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/pickup3/src/modules/pickup/items/HealthPickup.h @ 6486

Last change on this file since 6486 was 6477, checked in by dafrick, 15 years ago

Some more documenting. Completed HealthPickup.

File size: 6.0 KB
RevLine 
[6474]1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Damian 'Mozork' Frick
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29#ifndef _HealthPickup_H__
30#define _HealthPickup_H__
31
32#include "pickup/PickupPrereqs.h"
33
[6477]34#include <string>
35#include <worldentities/pawns/Pawn.h>
36#include "worldentities/StaticEntity.h"
37
[6474]38#include "pickup/Pickup.h"
39#include "tools/interfaces/Tickable.h"
40
41namespace orxonox {
42   
43    //! Enum for the type of the HealthPickup
44    namespace pickupHealthType
45    {
46        enum Value
47        {
48            limited,
49            temporary,
50            permanent
51        };
52    }
53   
[6477]54    /**
55    @brief
56        A pickup that can do (dependent upon the parameters) lots of different things to the health of a Pawn.
57        There are 4 parameters that can be choosen:
58        1) The health. The amount of health that (in a way dependent on the other parameters) is transfered to the Pawn.
59        2) The activation type: It can be chosen to be either 'immediate' or 'onUse'. The activation type essentially (as indicated by the name) defines when the health is transfered, either immediately after being picked up or only after the player uses it.
60        3) The duration type: It can be chosen to be either 'once' or 'continuous'. For 'once' the specified health is transfered once to the Pawn, for 'continuous' the set health is transfered over a span of time at a rate defined by the health rate parameter.
61        4) The health type: The health type can be choosen to be 'limited', 'temporary' or 'permanent'. 'limited' means that the health is increased only to the maximum health of the Pawn. 'temporary' means that the maximum health is temporarily elevated but will be set back as soon as the pickup is no longer in use. 'permanent' means that the maximum health of the Pawn is increased such that the health provided by the pickup will fit in and the maximum health stays that way.
62    @author
63        Damian 'Mozork' Frick
64    */
[6474]65    class _PickupExport HealthPickup : public Pickup, public Tickable
66    {
67        public:
68       
[6477]69            HealthPickup(BaseObject* creator); //!< Constructor.
70            virtual ~HealthPickup(); //!< Destructor.
[6474]71           
[6477]72            virtual void XMLPort(Element& xmlelement, orxonox::XMLPort::Mode mode); //!< Method for creating a HealthPickup object through XML.
73            virtual void tick(float dt); //!< Is called every tick.
[6474]74           
[6477]75            virtual void changedUsed(void); //!< Is called when the pickup has transited from used to unused or the other way around.
76            virtual void clone(OrxonoxClass* item); //!< Creates a duplicate of the input OrxonoxClass.
[6474]77           
[6477]78            /**
79            @brief Get the health that is transfered to the Pawn upon usage of this pickup.
80            @return Returns the health.
81            */
82            inline float getHealth(void)
83                { return this->health_; }
84            /**
85            @brief Get the rate at which the health is transferred to the Pawn, if this pickup has duration type 'continuous'.
86            @return Returns the rate.
87            */
88            inline float getHealthRate(void)
89                { return this->healthRate_; }
90               
91            /**
92            @brief Get the type of HealthPickup, this pickup is.
93            @return Returns the health type as an enum.
94            */
95            inline pickupHealthType::Value getHealthTypeDirect(void)
96                { return this->healthType_; }
97            const std::string& getHealthType(void); //!< Get the health type of this pickup.
98           
[6474]99        protected:
[6477]100            void initializeIdentifier(void); //!< Initializes the PickupIdentifier of this pickup.
[6474]101
[6477]102            void setHealth(float health); //!< Sets the health.
103            void setHealthRate(float speed); //!< Set the rate at which health is transferred if the pickup is continuous.
104           
105            /**
106            @brief Set the health type of this pickup.
107            @param type The type of this pickup as an enum.
108            */
[6474]109            inline void setHealthTypeDirect(pickupHealthType::Value type)
110                { this->healthType_ = type; }
[6477]111            void setHealthType(std::string type); //!< Set the type of the HealthPickup.
[6474]112       
113        private:
[6477]114            void initialize(void); //!< Initializes the member variables.
115            Pawn* carrierToPawnHelper(void); //!< Helper to transform the PickupCarrier to a Pawn, and throw an error message if the conversion fails.
[6474]116           
[6477]117            float health_; //!< The health that is transferred to the Pawn.
118            float healthRate_; //!< The rate at which the health is transferred.
119            float maxHealthSave_; //!< Helper to remember what the actual maxHealth of the Pawn was before we changed it.
120            float maxHealthOverwrite_; //!< Helper to remember with which value we overwrote the maxHealh, to detect if someone else changed it as well.
121            pickupHealthType::Value healthType_; //!< The type of the HealthPickup.
[6474]122           
[6477]123            //! Strings for the health types.
[6474]124            static const std::string healthTypeLimited_s;
125            static const std::string healthTypeTemporary_s;
126            static const std::string healthTypePermanent_s;
127       
128    };
129}
130
131#endif // _HealthPickup_H__
Note: See TracBrowser for help on using the repository browser.