Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/pickup3/src/modules/pickup/PickupSpawner.h @ 6484

Last change on this file since 6484 was 6475, checked in by dafrick, 15 years ago

Additional documentation, code niceifying and potential bug fixing. Also: Renamed DroppedItem to DroppedPickup.

  • Property svn:eol-style set to native
File size: 4.9 KB
Line 
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 *      Daniel 'Huty' Haggenmueller
24 *   Co-authors:
25 *      Damian 'Mozork' Frick
26 *
27 */
28
29/**
30    @file
31    @brief Definition of PickupSpawner.
32*/
33
34#ifndef _PickupSpawner_H__
35#define _PickupSpawner_H__
36
37#include "PickupPrereqs.h"
38
39#include <string>
40#include "interfaces/Pickupable.h"
41#include "tools/Timer.h"
42
43#include "tools/interfaces/Tickable.h"
44#include "worldentities/StaticEntity.h"
45
46namespace orxonox
47{
48    /**
49        @brief
50            The PickupSpawner class is responsible for spawning pickups of a specific type.
51            Forthermore it can be specified how long the time interval between spawning two items is and how many pickups are spawned at maximum, amongst other things.
52        @author
53            Daniel 'Huty' Haggenmueller
54            Damian 'Mozork' Frick
55    */
56    class _OrxonoxExport PickupSpawner : public StaticEntity, public Tickable
57    {
58        public:
59            PickupSpawner(BaseObject* creator); //!< Default Constructor.
60            PickupSpawner(BaseObject* creator, Pickupable* pickup, float triggerDistance, float respawnTime, int maxSpawnedItems); //!< Constructor.
61            virtual ~PickupSpawner(); //!< Destructor.
62
63            virtual void XMLPort(Element& xmlelement, XMLPort::Mode mode);  //!< Method for creating a PickupSpawner through XML.
64            virtual void changedActivity(); //!< Invoked when activity has changed (set visibilty).
65            virtual void tick(float dt);
66
67            /**
68            @brief Get the distance in which to trigger.
69            @return Returns the distance in which this gets triggered.
70            */
71            inline float getTriggerDistance() const
72                { return this->triggerDistance_; }
73            /**
74            @brief Set the distance in which to trigger.
75            @param value The new distance in which to trigger.
76            */
77            inline void setTriggerDistance(float value)
78                { this->triggerDistance_ = value; }
79
80            /**
81            @brief Get the time to respawn.
82            @returns Returns the time after which this gets re-actived.
83            */
84            inline float getRespawnTime() const
85                { return this->respawnTime_; }
86            /**
87            @brief Set the time to respawn.
88            @param time New time after which this gets re-actived.
89            */
90            inline void setRespawnTime(float time)
91                { this->respawnTime_ = time; }
92
93            /**
94            @brief Get the maximum number of items that will be spawned by this PickupSpawner.
95            @return Returns the maximum number of items spawned by this PickupSpawner.
96            */
97            inline int getMaxSpawnedItems(void)
98                { return this->maxSpawnedItems_; }
99            void setMaxSpawnedItems(int items); //!< Sets the maximum number of spawned items.
100
101        protected:
102            void decrementSpawnsRemaining(void); //!< Decrements the number of remaining spawns.
103           
104            virtual Pickupable* getPickup(void); //!< Creates a new Pickupable.
105           
106            void setPickupable(Pickupable* pickup); //!< Sets a Pickupable for the PickupSpawner to spawn.
107            const Pickupable* getPickupable(void); //!< Get the Pickupable that is spawned by this PickupSpawner.
108           
109            Pickupable* pickup_; //!< The pickup to be spawned.
110
111        private:
112            void initialize(void);
113           
114            void trigger(Pawn* pawn); //!< Method called when a Pawn is close enough.
115            void respawnTimerCallback(); //!< Method called when the timer runs out.
116
117            int maxSpawnedItems_; //!< Maximum number of items spawned by this PickupSpawner.
118            int spawnsRemaining_; //!< Number of items that can be spawned by this PickupSpawner until it selfdestructs.
119
120            float triggerDistance_; //!< Distance in which this gets triggered.
121
122            float respawnTime_; //!< Time after which this gets re-actived.
123            Timer respawnTimer_; //!< Timer used for re-activating.
124
125            static const int INF = -1; //!< Constant for infinity.
126    };
127}
128
129#endif /* _PickupSpawner_H__ */
Note: See TracBrowser for help on using the repository browser.