/* * ORXONOX - the hottest 3D action shooter ever to exist * > www.orxonox.net < * * * License notice: * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * Author: * Reto Grieder * Benjamin Knecht * Co-authors: * ... * */ /** @file @ingroup Graphics */ #ifndef _GUIManager_H__ #define _GUIManager_H__ #include "CorePrereqs.h" #include #include #include #if CEGUI_VERSION >= 0x000800 # include # include #else # include # include #endif #include "util/DestructionHelper.h" #include "util/OgreForwardRefs.h" #include "util/tribool.h" #include "util/Singleton.h" #include "input/InputHandler.h" #include "WindowEventListener.h" #if CEGUI_VERSION_MAJOR < 1 && CEGUI_VERSION_MINOR < 7 # define ORXONOX_OLD_CEGUI #endif namespace orxonox // tolua_export { // tolua_export class PlayerInfo; // Forward declaration // Acquaint Tolua with tribool /* tolua_begin struct dontcare_keyword_t { dontcare_keyword_t(); }; class tribool { tribool(bool value); tribool(dontcare_keyword_t); bool operator==(tribool); }; tolua_end */ /** @class GUIManager @brief Provides a simple interface to CEGUI with tolua methods and console commands. It also acts as a key and mouse handler. The GUIManager is a singleton and can be called anywhere when access on the GUI is needed. Since the GUI needs user input, the GUIManager implements the functions needed to act as a key and/or mouse handler. Those input events are then injected into CEGUI in Lua. */ class _CoreExport GUIManager // tolua_export : public Singleton, public InputHandler, public WindowEventListener { // tolua_export friend class Singleton; public: GUIManager(const std::pair& mousePosition); //! Leave empty and use cleanup() instead ~GUIManager() = default; /// Destructor that also executes when object fails to construct void destroy(); void setConfigValues(void); void changedGUIScheme(void); void preUpdate(const Clock& time); std::vector getLoadedGUIs(); void loadGUI(const std::string& name); static void showGUI(const std::string& name, bool bHidePrevious = false, bool bNoInput = false); void showGUIExtra(const std::string& name, const std::string& ptr, bool bHidePrevious = false, bool bNoInput = false); static void hideGUI(const std::string& name); static void toggleGUI(const std::string& name, bool bHidePrevious = false, bool bNoInput = false); void toggleGUIHelper(const std::string& name, bool bHidePrevious, bool bNoInput, bool show); // tolua_export void keyESC(); void setBackgroundImage(const std::string& imageSet, const std::string imageName); // tolua_export void setBackgroundImage(const std::string& image); static bool preloadMenuSheets() { return GUIManager::getInstance().bPreloadMenuSheets_; } // tolua_export static bool inDevMode(void); // tolua_export //! Creates a new InputState to be used with a GUI Sheet const std::string& createInputState(const std::string& name, tribool showCursor = tribool(true), tribool useKeyboard = tribool(true), bool bBlockJoyStick = false); // tolua_export LuaState* getLuaState(void) { return this->luaState_; } //! Returns the root window for all menu sheets CEGUI::Window* getMenuRootWindow() { return this->menuRootWindow_; } // tolua_export //! Returns the root window for all HUD sheets CEGUI::Window* getHUDRootWindow() { return this->hudRootWindow_; } // tolua_export void setCamera(Ogre::Camera* camera); Ogre::Camera* getCamera() { return this->camera_; } inline void setPlayer(const std::string& guiname, PlayerInfo* player) { this->players_[guiname] = player; } inline orxonox::PlayerInfo* getPlayer(const std::string& guiname) const { std::map::const_iterator it = this->players_.find(guiname); return (it != this->players_.end()) ? it->second : nullptr; } // tolua_export // TODO: Temporary hack because the tolua exported CEGUI method does not seem to work static void subscribeEventHelper(CEGUI::Window* window, const std::string& event, const std::string& function); // tolua_export static void setTooltipTextHelper(CEGUI::ListboxItem* item, const std::string& toooltip); // tolua_export static void setItemTooltipsEnabledHelper(CEGUI::Listbox* listbox, bool enabled); // tolua_export static void addFontHelper(const std::string& name, int size, const std::string& fontName); // tolua_export static float getFontTextExtent(const CEGUI::Font* font, const std::string& text, float x_scale = 1.0f); // tolua_export static GUIManager& getInstance() { return Singleton::getInstance(); } // tolua_export /** @brief Check whether CEGUI is version < 0.7. @return Returns true if the CEGUI version is < 0.7. False otherwise. */ inline bool usingOldCEGUI(void) { return this->oldCEGUI_; } // tolua_export private: // non-copyable: GUIManager(const GUIManager&) = delete; GUIManager& operator=(const GUIManager&) = delete; void executeCode(const std::string& str); template bool protectedCall(FunctionType function, ObjectType object); template bool protectedCeguiSystemCall(FunctionType function); #if CEGUI_VERSION >= 0x000800 template bool protectedCeguiContextCall(FunctionType function); #endif void changedCeguiOutputLevel(); // keyHandler functions virtual void buttonPressed (const KeyEvent& evt) override; virtual void buttonReleased(const KeyEvent& evt) override; // mouseHandler functions virtual void buttonPressed (MouseButtonCode::ByEnum id) override; virtual void buttonReleased(MouseButtonCode::ByEnum id) override; virtual void mouseMoved (IntVector2 abs, IntVector2 rel, IntVector2 clippingSize) override; virtual void mouseScrolled (int abs, int rel) override; void mouseLeft (); // window event handler virtual void windowResized(unsigned int newWidth, unsigned int newHeight) override; virtual void windowFocusChanged(bool bFocus) override; #ifdef ORXONOX_OLD_CEGUI CEGUI::OgreCEGUIRenderer* guiRenderer_; //!< CEGUI's interface to the Ogre Engine CEGUI::ResourceProvider* resourceProvider_; //!< CEGUI's resource provider #else CEGUI::OgreRenderer* guiRenderer_; //!< CEGUI's interface to the Ogre Engine CEGUI::OgreResourceProvider* resourceProvider_; //!< CEGUI's resource provider Ogre::RenderQueueListener* rqListener_; //!< RQ listener so we can draw UNDER Ogre overlays CEGUI::OgreImageCodec* imageCodec_; #endif LuaState* luaState_; //!< LuaState, access point to the Lua engine CEGUI::LuaScriptModule* scriptModule_; //!< CEGUI's script module to use Lua CEGUI::System* guiSystem_; //!< CEGUI's main system std::shared_ptr rootFileInfo_; //!< Resource information about the root script CEGUI::Logger* ceguiLogger_; //!< CEGUI's logger to be able to log CEGUI errors in our log int outputLevelCeguiLog_; //!< CEGUI's log level CEGUI::Window* rootWindow_; //!< Root node for all windows CEGUI::Window* hudRootWindow_; //!< Root node for the HUD sheets CEGUI::Window* menuRootWindow_; //!< Root node for the menu sheets (used by Lua) std::map players_; //!< Stores the player (owner) for each GUI Ogre::Camera* camera_; //!< Camera used to render the scene with the GUI /// Helper object that executes the surrogate destructor destroy() DestructionHelper destructionHelper_; static GUIManager* singletonPtr_s; //!< Singleton reference to GUIManager // The used CEGUI scheme. static const std::string defaultScheme_; std::string guiScheme_; bool oldCEGUI_; int numScrollLines_; ///< How many lines to scroll in a list if the scroll wheel is used bool bPreloadMenuSheets_; ///< If true, menu sheets are pre-loaded during startup }; // tolua_export } // tolua_export #endif /* _GUIManager_H__ */