Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/modules/questsystem/QuestManager.h @ 8744

Last change on this file since 8744 was 8706, checked in by dafrick, 14 years ago

Merging presentation branch back into trunk.
There are many new features and also a lot of other changes and bugfixes, if you want to know, digg through the svn log.
Not everything is yet working as it should, but it should be fairly stable. If you habe any bug reports, just send me an email.

  • Property svn:eol-style set to native
File size: 4.8 KB
RevLine 
[1996]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
[2261]29/**
[7456]30    @file QuestManager.h
[2662]31    @brief Definition of the QuestManager class.
[7456]32    @ingroup Questsystem
[2261]33*/
34
[1996]35#ifndef _QuestManager_H__
36#define _QuestManager_H__
37
[5722]38#include "questsystem/QuestsystemPrereqs.h"
[2095]39
[3196]40#include <list>
[1996]41#include <map>
42#include <string>
[3370]43
[5929]44#include "util/Singleton.h"
[2911]45#include "core/OrxonoxClass.h"
[1996]46
[7456]47namespace orxonox  // tolua_export
48{  // tolua_export
[7552]49
[1996]50    /**
51    @brief
[7456]52        Is a Singleton and manages @ref orxonox::Quest "Quests", by registering every @ref orxonox::Quest "Quest" / @ref orxonox::QuestHint "QuestHint" (through registerX()) and making them globally accessible (through findX()).
[7484]53        @ref orxonox::Quest "Quests" (and @ref orxonox::QuestHint "QuestHints") are registered in the QuestManager with their id, and can be accessed in the same way.
[7552]54
[1996]55    @author
56        Damian 'Mozork' Frick
[7552]57
58    @ingroup Questsystem
[1996]59    */
[7456]60    class _QuestsystemExport QuestManager  // tolua_export
[5929]61        : public Singleton<QuestManager>, public orxonox::OrxonoxClass
62    { // tolua_export
[5745]63
[5929]64            friend class Singleton<QuestManager>;
[5745]65
[2093]66        public:
[2911]67            QuestManager();
[2093]68            virtual ~QuestManager();
[2092]69
[7456]70            //! Returns a reference to the single instance of the QuestManager.
[5929]71            static QuestManager& getInstance() { return Singleton<QuestManager>::getInstance(); } // tolua_export
[2092]72
[7163]73            // tolua_begin
[7456]74            int getNumRootQuests(orxonox::PlayerInfo* player); //!< Get the number of Quests the input player has, that are root quests.
75            Quest* getRootQuest(orxonox::PlayerInfo* player, int index); //!< Get the index-th root quest of the input player.
[5745]76
[7456]77            int getNumSubQuests(Quest* quest, orxonox::PlayerInfo* player); //!< Get the number of sub-quest of an input Quest for an input player.
78            Quest* getSubQuest(Quest* quest, orxonox::PlayerInfo* player, int index); //!< Get the index-th sub-quest of the input Quest for the input player.
[7163]79
[7456]80            int getNumHints(Quest* quest, orxonox::PlayerInfo* player); //!< Get the number of QuestHints of the input Quest for the input player.
81            QuestHint* getHints(Quest* quest, orxonox::PlayerInfo* player, int index); //!< Get the index-th QuestHint of the input Quest for the input player.
[7163]82
[8706]83            Quest* getParentQuest(Quest* quest); //!< Get the parent-quest of the input Quest.
84
85            QuestDescription* getDescription(Quest* item); //!< Get the QuestDescription of the input Quest.
86            QuestDescription* getDescription(QuestHint* item); //!< Get the QuestDescription of the input QuestHint.
87
88            const std::string getId(Quest* item) const; //!< Get the id of the input Quest.
89            const std::string getId(QuestHint* item) const; //!< Get the id of the input QuestHint.
[7163]90            // tolua_end
91
[2911]92            bool registerQuest(Quest* quest); //!< Registers a Quest in the QuestManager.
[7163]93            bool unregisterQuest(Quest* quest); //!< Unregisters a Quest in the QuestManager.
94            bool registerHint(QuestHint* hint); //!< Registers a QuestHint in the QuestManager.
95            bool unregisterHint(QuestHint* hint); //!< Unregisters a QuestHint in the QuestManager.
[2092]96
[2911]97            Quest* findQuest(const std::string & questId); //!< Returns the Quest with the input id.
98            QuestHint* findHint(const std::string & hintId); //!< Returns the QuestHint with the input id.
99
[5745]100        protected:
[6536]101            std::map<std::string, Quest*> & getQuests(void); //!< Retrieve all Quests.
[2960]102
[2093]103        private:
[3370]104            static QuestManager* singletonPtr_s;
[6536]105            PlayerInfo* retrievePlayer(const std::string & guiName); //!< Retrieve the player for a certain GUI.
[2092]106
[2911]107            std::map<std::string, Quest*> questMap_; //!< All Quests registered by their id's.
108            std::map<std::string, QuestHint*> hintMap_; //!< All QuestHints registered by their id's.
109
[2960]110    }; // tolua_export
[1996]111
[2960]112} // tolua_export
[1996]113
114#endif /* _QuestManager_H__ */
Note: See TracBrowser for help on using the repository browser.