Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/libraries/core/GUIManager.h @ 8666

Last change on this file since 8666 was 8530, checked in by landauf, 14 years ago

added config value to define the scroll speed in CEGUI listboxes. default 1 line.

  • Property svn:eol-style set to native
File size: 8.4 KB
RevLine 
[1638]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 *      Reto Grieder
[3196]24 *      Benjamin Knecht
[1638]25 *   Co-authors:
[3196]26 *      ...
[1638]27 *
28 */
29
[7401]30/**
31    @file
32    @ingroup Graphics
33*/
34
[1638]35#ifndef _GUIManager_H__
36#define _GUIManager_H__
37
[3346]38#include "CorePrereqs.h"
[3196]39
40#include <map>
[6417]41#include <set>
[3196]42#include <string>
[1638]43#include <CEGUIForwardRefs.h>
[8351]44#include <CEGUIVersion.h>
[5695]45#include <boost/shared_ptr.hpp>
[3196]46
[8423]47#include "util/DestructionHelper.h"
[3196]48#include "util/OgreForwardRefs.h"
[6746]49#include "util/TriBool.h"
[3366]50#include "util/Singleton.h"
[3346]51#include "input/InputHandler.h"
[8079]52#include "Core.h"
[7801]53#include "OrxonoxClass.h"
[7873]54#include "WindowEventListener.h"
[1638]55
[6746]56// Tolua includes (have to be relative to the current directory)
57/*
58$cfile "../util/TriBool.h" // tolua_export
59*/
60
[8351]61#if CEGUI_VERSION_MAJOR < 1 && CEGUI_VERSION_MINOR < 7
62#  define ORXONOX_OLD_CEGUI
63#endif
64
[6417]65namespace orxonox // tolua_export
66{ // tolua_export
[5693]67    class PlayerInfo; // Forward declaration
68
[1638]69    /**
[2896]70    @class GUIManager
[1638]71    @brief
[2896]72        Provides a simple interface to CEGUI with tolua methods and console commands. It also acts as a key and mouse handler.
73
74        The GUIManager is a singleton and can be called anywhere when access on the GUI is needed.
75
76        Since the GUI needs user input, the GUIManager implements the functions needed to act as a key and/or mouse handler.
77        Those input events are then injected into CEGUI in Lua.
[1638]78    */
[6417]79    class _CoreExport GUIManager // tolua_export
[7873]80        : public Singleton<GUIManager>, public InputHandler, public WindowEventListener
[6417]81    { // tolua_export
[3366]82        friend class Singleton<GUIManager>;
[1638]83    public:
[6746]84        GUIManager(const std::pair<int, int>& mousePosition);
[8423]85
[8351]86        //! Leave empty and use cleanup() instead
87        ~GUIManager() {}
[8423]88        /// Destructor that also executes when object fails to construct
89        void destroy();
[1646]90
[7801]91        void setConfigValues(void);
92        void changedGUIScheme(void);
93
[6417]94        void preUpdate(const Clock& time);
[1640]95
[6746]96        void loadGUI(const std::string& name);
[7403]97        static void showGUI(const std::string& name, bool bHidePrevious = false, bool bNoInput = false);
98        void showGUIExtra(const std::string& name, const std::string& ptr, bool bHidePrevious = false, bool bNoInput = false);
[6417]99        static void hideGUI(const std::string& name);
[8079]100        static void toggleGUI(const std::string& name, bool bHidePrevious = false, bool bNoInput = false);
101        void toggleGUIHelper(const std::string& name, bool bHidePrevious, bool bNoInput, bool show); // tolua_export
[6417]102        void keyESC();
[6746]103        void setBackgroundImage(const std::string& imageSet, const std::string imageName); // tolua_export
104        void setBackgroundImage(const std::string& image);
[1638]105
[8079]106        /**
107        @brief Helper method to get the developer's mode without having to export Core.h.
108        @see Core::inDevMode
109        */
110        static bool inDevMode(void) { return Core::getInstance().inDevMode(); } // tolua_export
111
[6746]112        //! Creates a new InputState to be used with a GUI Sheet
113        const std::string& createInputState(const std::string& name, TriBool::Value showCursor = TriBool::True, TriBool::Value useKeyboard = TriBool::True, bool bBlockJoyStick = false); // tolua_export
[7163]114        LuaState* getLuaState(void)
[8351]115            { return this->luaState_; }
[6746]116
117        //! Returns the root window for all menu sheets
118        CEGUI::Window* getMenuRootWindow() { return this->menuRootWindow_; } // tolua_export
119        //! Returns the root window for all HUD sheets
120        CEGUI::Window* getHUDRootWindow() { return this->hudRootWindow_; } // tolua_export
121
[2896]122        void setCamera(Ogre::Camera* camera);
[5929]123        Ogre::Camera* getCamera() { return this->camera_; }
[2896]124
[5693]125        inline void setPlayer(const std::string& guiname, PlayerInfo* player)
126            { this->players_[guiname] = player; }
[7163]127        inline orxonox::PlayerInfo* getPlayer(const std::string& guiname) const { std::map<std::string, PlayerInfo*>::const_iterator it = this->players_.find(guiname); return (it != this->players_.end()) ? it->second : 0; } // tolua_export
[5693]128
[6417]129        // TODO: Temporary hack because the tolua exported CEGUI method does not seem to work
130        static void subscribeEventHelper(CEGUI::Window* window, const std::string& event, const std::string& function); //tolua_export
[7648]131        static void setTooltipTextHelper(CEGUI::ListboxItem* item, const std::string& toooltip); //tolua_export
132        static void setItemTooltipsEnabledHelper(CEGUI::Listbox* listbox, bool enabled); //tolua_export
[6417]133
[6746]134        static GUIManager& getInstance() { return Singleton<GUIManager>::getInstance(); } // tolua_export
135
[1638]136    private:
[3339]137        GUIManager(const GUIManager& instance); //!< private and undefined copy c'tor (this is a singleton class)
[8351]138
[7163]139        void executeCode(const std::string& str);
[1638]140
[6746]141        template <typename FunctionType>
142        bool protectedCall(FunctionType function);
143
[2896]144        // keyHandler functions
[7163]145        void buttonPressed (const KeyEvent& evt);
146        void buttonReleased(const KeyEvent& evt);
[1638]147
[2896]148        // mouseHandler functions
[3327]149        void buttonPressed (MouseButtonCode::ByEnum id);
150        void buttonReleased(MouseButtonCode::ByEnum id);
151        void mouseMoved    (IntVector2 abs, IntVector2 rel, IntVector2 clippingSize);
152        void mouseScrolled (int abs, int rel);
[7874]153        void mouseLeft     ();
[6749]154
[7873]155        // window event handler
156        virtual void windowResized(unsigned int newWidth, unsigned int newHeight);
[7874]157        virtual void windowFocusChanged(bool bFocus);
[7873]158
[8351]159#ifdef ORXONOX_OLD_CEGUI
160        CEGUI::OgreCEGUIRenderer*            guiRenderer_;      //!< CEGUI's interface to the Ogre Engine
161        CEGUI::ResourceProvider*             resourceProvider_; //!< CEGUI's resource provider
162#else
163        CEGUI::OgreRenderer*                 guiRenderer_;      //!< CEGUI's interface to the Ogre Engine
[8411]164        CEGUI::OgreResourceProvider*         resourceProvider_; //!< CEGUI's resource provider
[8351]165        Ogre::RenderQueueListener*           rqListener_;       //!< RQ listener so we can draw UNDER Ogre overlays
166        CEGUI::OgreImageCodec*               imageCodec_;
167#endif
168        LuaState*                            luaState_;         //!< LuaState, access point to the Lua engine
169        CEGUI::LuaScriptModule*              scriptModule_;     //!< CEGUI's script module to use Lua
170        CEGUI::System*                       guiSystem_;        //!< CEGUI's main system
[5695]171        shared_ptr<ResourceInfo>             rootFileInfo_;     //!< Resource information about the root script
172        CEGUI::Logger*                       ceguiLogger_;      //!< CEGUI's logger to be able to log CEGUI errors in our log
[6746]173        CEGUI::Window*                       rootWindow_;       //!< Root node for all windows
174        CEGUI::Window*                       hudRootWindow_;    //!< Root node for the HUD sheets
175        CEGUI::Window*                       menuRootWindow_;   //!< Root node for the menu sheets (used by Lua)
176        std::map<std::string, PlayerInfo*>   players_;          //!< Stores the player (owner) for each GUI
[5929]177        Ogre::Camera*                        camera_;           //!< Camera used to render the scene with the GUI
[1638]178
[8423]179        /// Helper object that executes the surrogate destructor destroy()
180        DestructionHelper<GUIManager>        destructionHelper_;
181
[5695]182        static GUIManager*                   singletonPtr_s;    //!< Singleton reference to GUIManager
[1638]183
[7801]184        // The used CEGUI scheme.
185        static const std::string defaultScheme_;
186        std::string guiScheme_;
187
[8530]188        int numScrollLines_; ///< How many lines to scroll in a list if the scroll wheel is used
189
[6417]190    }; // tolua_export
191} // tolua_export
[1638]192
193#endif /* _GUIManager_H__ */
Note: See TracBrowser for help on using the repository browser.