source: code/branches/release2012/src/libraries/core/Core.h @ 10973

/*
 *   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:
 *      Fabian 'x3n' Landau
 *      Reto Grieder
 *   Co-authors:
 *      ...
 *
 */

/**
    @defgroup CoreGame Core and Game
    @ingroup Management
*/

/**
    @file
    @ingroup Management CoreGame
    @brief Declaration of the Core singleton which is used to configure the program basics.
*/

#ifndef _Core_H__
#define _Core_H__

#include "CorePrereqs.h"

#include <string>
#include "util/DestructionHelper.h"
#include "util/Singleton.h"
#include "OrxonoxClass.h"

namespace orxonox
{
    //! Informs about changes in the Development Mode.
    class DevModeListener : virtual public OrxonoxClass
    {
    public:
        DevModeListener();
        virtual ~DevModeListener() {}
        virtual void devModeChanged(bool value) = 0;
    };

    /**
    @brief
        The Core class is a singleton used to configure the program basics.
    @remark
        You should only create this singleton once because it destroys the identifiers!
    */
    class _CoreExport Core : public Singleton<Core>, public OrxonoxClass
    {
        friend class Singleton<Core>;
        friend class Game;

        public:
            /**
            @brief
                Determines the executable path, checks for build directory runs, creates
                the output directories and sets up the other core library singletons.
            @throws
                GeneralException
            */
            Core(const std::string& cmdLine);

            /// Leave empty and use destroy() instead
            ~Core() {}
            /// Destructor that also executes when the object fails to construct
            void destroy();

            void setConfigValues();

            //! Returns the configured language.
            const std::string& getLanguage()
                { return this->language_; }
            void resetLanguage();

            void updateLastLevelTimestamp();
            inline long long getLastLevelTimestamp() const
                { return this->lastLevelTimestamp_; }

            void updateOgreConfigTimestamp();
            inline long long getOgreConfigTimestamp() const
                { return this->ogreConfigTimestamp_; }

            //! Developers bit. If returns false, some options are not available as to not confuse the normal user.
            inline bool inDevMode(void) const
                { return this->bDevMode_; }

        private:
            Core(const Core&); //!< Don't use (undefined symbol)

            void devModeChanged();
            void languageChanged();
            void initRandomNumberGenerator();

            void preUpdate(const Clock& time);
            void postUpdate(const Clock& time);

            void loadGraphics();
            void unloadGraphics();

            void setThreadAffinity(int limitToCPU);

            PathConfig*               pathConfig_;
            DynLibManager*            dynLibManager_;
            SignalHandler*            signalHandler_;
            ConfigFileManager*        configFileManager_;
            Language*                 languageInstance_;
            IOConsole*                ioConsole_;
            TclBind*                  tclBind_;
            TclThreadManager*         tclThreadManager_;
            Scope<ScopeID::Root>*     rootScope_;
            // graphical
            GraphicsManager*          graphicsManager_;            //!< Interface to OGRE
            InputManager*             inputManager_;               //!< Interface to OIS
            GUIManager*               guiManager_;                 //!< Interface to GUI
            Scope<ScopeID::Graphics>* graphicsScope_;

            bool                      bGraphicsLoaded_;
            std::string               language_;                   //!< The language
            bool                      bInitRandomNumberGenerator_; //!< If true, srand(time(0)) is called
            bool                      bStartIOConsole_;            //!< Set to false if you don't want to use the IOConsole
            long long                 lastLevelTimestamp_;         ///< Timestamp when the last level was started
            long long                 ogreConfigTimestamp_;        ///< Timestamp wehen the ogre config level was modified
            bool                      bDevMode_;                   //!< Developers bit. If set to false, some options are not available as to not confuse the normal user.

            /// Helper object that executes the surrogate destructor destroy()
            DestructionHelper<Core>   destructionHelper_;

            static Core*              singletonPtr_s;
    };
}

#endif /* _Core_H__ */