Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/orxonox/objects/quest/QuestDescription.h @ 2781

Last change on this file since 2781 was 2710, checked in by rgrieder, 16 years ago

Merged buildsystem3 containing buildsystem2 containing Adi's buildsystem branch back to the trunk.
Please update the media directory if you were not using buildsystem3 before.

  • Property svn:eol-style set to native
  • Property svn:mergeinfo set to (toggle deleted branches)
    /code/branches/lodfinal/src/orxonox/objects/quest/QuestDescription.hmergedeligible
    /code/trunk/src/orxonox/objects/quest/QuestDescription.hmergedeligible
    /code/branches/buildsystem2/src/orxonox/objects/quest/QuestDescription.h2506-2658
    /code/branches/buildsystem3/src/orxonox/objects/quest/QuestDescription.h2662-2708
    /code/branches/network/src/orxonox/objects/quest/QuestDescription.h2356
    /code/branches/network64/src/orxonox/objects/quest/QuestDescription.h2210-2355
    /code/branches/objecthierarchy2/src/orxonox/objects/quest/QuestDescription.h2171-2479
    /code/branches/overlay/src/orxonox/objects/quest/QuestDescription.h2117-2385
    /code/branches/physics/src/orxonox/objects/quest/QuestDescription.h2107-2439
    /code/branches/physics_merge/src/orxonox/objects/quest/QuestDescription.h2436-2457
    /code/branches/pickups2/src/orxonox/objects/quest/QuestDescription.h2107-2497
    /code/branches/presentation/src/orxonox/objects/quest/QuestDescription.h2369-2652,​2654-2660
    /code/branches/questsystem2/src/orxonox/objects/quest/QuestDescription.h2107-2259
    /code/branches/weapon2/src/orxonox/objects/quest/QuestDescription.h2107-2488
File size: 5.6 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/**
[2662]30    @file
31    @brief Definition of the QuestDescription class.
[2261]32*/
33
[1996]34#ifndef _QuestDescription_H__
35#define _QuestDescription_H__
36
[2095]37#include "OrxonoxPrereqs.h"
38
[1996]39#include <string>
40
41#include "core/BaseObject.h"
[2068]42#include "core/XMLPort.h"
[1996]43
[2662]44namespace orxonox
45{
[1996]46    /**
47    @brief
48        This class is a description of a QuestItem.
49        It holds a title and a description.
[2261]50       
51        Creating a QuestDescription through XML goes as follows:
52       
[2662]53        <QuestDescription title="Title" description="Description Text" failMessage="You fail." completeMessage="You win!" />
[1996]54    @author
55        Damian 'Mozork' Frick
56    */
[2662]57    class _OrxonoxExport QuestDescription : public BaseObject
58    {
[2093]59        public:
[2092]60            QuestDescription(BaseObject* creator);
[2093]61            virtual ~QuestDescription();
[2092]62
[2261]63            virtual void XMLPort(Element& xmlelement, XMLPort::Mode mode); //!< Method for creating a QuestDescription object through XML.
[2092]64
[2662]65            /**
66            @brief Returns the title.
67            @return Returns a string containing the title of the QuestDescription.
68            */
[2261]69            inline const std::string & getTitle(void) const
[1996]70                { return this->title_; }
[2261]71       
[2662]72            /**
73            @brief Returns the description text.
74            @return Returns a string containing the description text of the QuestDescription.
75            */
[2261]76            inline const std::string & getDescription(void) const
[1996]77                { return this->description_; }
[2662]78       
79            /**
80            @brief Returns the fail message.
81            @return Returns a string containing the fail message of the QuestDescription.
82            */
83            inline const std::string & getFailMessage(void) const
84                { return this->failMessage_; }
85       
86            /**
87            @brief Returns the complete message.
88            @return Returns a string containing the complete message of the QuestDescription.
89            */
90            inline const std::string & getCompleteMessage(void) const
91                { return this->completeMessage_; }
92       
93            /**
94            @brief Sends a Notification displaying that a QuestHint was added.
95            @return Returns true if successful.
96            */
97            inline bool sendAddHintNotification(void) const
98                { return notificationHelper("hint", ""); }
99       
100            /**
101            @brief Sends a Notification displaying that a Quest was added.
102            @return Returns true if successful.
103            */
104            inline bool sendAddQuestNotification(void) const
105                { return notificationHelper("quest", "start"); }
106       
107            /**
108            @brief Sends a Notification displaying that a Quest was failed.
109            @return Returns true if successful.
110            */
111            inline bool sendFailQuestNotification(void) const
112                { return notificationHelper("quest", "fail"); }
113       
114            /**
115            @brief Sends a Notification displaying that a Quest was completed.
116            @return Returns true if successful.
117            */
118            inline bool sendCompleteQuestNotification(void) const
119                { return notificationHelper("quest", "complete"); }
[2092]120
[2093]121        private:
[2261]122            std::string title_; //!< The title.
123            std::string description_; //!< The description.
[2662]124            std::string failMessage_; //!< The message displayed when the Quest is failed.
125            std::string completeMessage_; //!< The message displayed when the Quest is completed.
[2092]126
[2662]127            bool notificationHelper(const std::string & item, const std::string & status) const; //!< Helper for sending QuestDescriptions as Notifications.
128
[2261]129            /**
130            @brief Sets the title.
131            @param title The title to be set.
132            */
133            inline void setTitle(const std::string & title)
[2068]134                { this->title_ = title; }
[2261]135               
[2662]136            /**
[2261]137            @brief Sets the description text.
138            @param description The description text to be set.
139            */
140            inline void setDescription(const std::string & description)
[2068]141                { this->description_ = description; }
[2092]142
[2662]143            /**
144            @brief Sets the fail message.
145            @param message The fail message to be set.
146            */
147            inline void setFailMessage(const std::string & message)
148                { this->failMessage_ = message; }
149               
150            /**
151            @brief Sets the complete message.
152            @param message The complete message to be set.
153            */
154            inline void setCompleteMessage(const std::string & message)
155                { this->completeMessage_ = message; }
156
[1996]157    };
158
159}
160
161#endif /* _QuestDescription_H__ */
Note: See TracBrowser for help on using the repository browser.