OutputManager.h

Go to the documentation of this file.

/*
 *   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
 *   Co-authors:
 *      ...
 *
 */

#ifndef _OutputManager_H__
#define _OutputManager_H__

#include "util/UtilPrereqs.h"

#include <vector>
#include <map>
#include <memory>

#include "OutputDefinitions.h"
#include "AdditionalContextListener.h"

namespace orxonox
{
    class _UtilExport OutputManager : public AdditionalContextListener
    {
        public:
            OutputManager();
            virtual ~OutputManager();

            static OutputManager& getInstance();
            static OutputManager& getInstanceAndCreateListeners();

            inline MemoryWriter* getMemoryWriter()   { return this->memoryWriterInstance_; }
            inline ConsoleWriter* getConsoleWriter() { return this->consoleWriterInstance_; }
            inline LogWriter* getLogWriter()         { return this->logWriterInstance_; }

            virtual void pushMessage(OutputLevel level, const OutputContextContainer& context, const std::string& message);

            virtual void registerListener(OutputListener* listener);
            virtual void unregisterListener(OutputListener* listener);

            virtual void updatedLevelMask(const OutputListener* listener) override
                { this->updateCombinedLevelMask(); }
            virtual void updatedAdditionalContextsLevelMask(const OutputListener* listener) override
                { this->updateCombinedAdditionalContextsLevelMask(); }
            virtual void updatedAdditionalContextsMask(const OutputListener* listener) override
                { this->updateCombinedAdditionalContextsMask(); }

            inline bool acceptsOutput(OutputLevel level, const OutputContextContainer& context) const
            {
                return (this->combinedLevelMask_ & level) ||
                       ((this->combinedAdditionalContextsLevelMask_ & level) && (this->combinedAdditionalContextsMask_ & context.mask));
            }

            const OutputContextContainer& registerContext(const std::string& name, const std::string& subname = "");

            const std::string& getLevelName(OutputLevel level) const;
            std::string getDefaultPrefix(OutputLevel level, const OutputContextContainer& context) const;

            inline const std::vector<OutputListener*>& getListeners() const
                { return this->listeners_; }

            inline OutputLevel getCombinedLevelMask() const { return this->combinedLevelMask_; }
            inline OutputLevel getCombinedAdditionalContextsLevelMask() const { return this->combinedAdditionalContextsLevelMask_; }
            inline OutputContextMask getCombinedAdditionalContextsMask() const { return this->combinedAdditionalContextsMask_; }

        private:
            // non-copyable:
            OutputManager(const OutputManager&) = delete;
            OutputManager& operator=(const OutputManager&) = delete;

            void updateMasks();
            void updateCombinedLevelMask();
            void updateCombinedAdditionalContextsLevelMask();
            void updateCombinedAdditionalContextsMask();

            std::vector<OutputListener*> listeners_;                            

            OutputLevel       combinedLevelMask_;                               
            OutputLevel       combinedAdditionalContextsLevelMask_;             
            OutputContextMask combinedAdditionalContextsMask_;                  

            std::map<std::string, OutputContextMask> contextMasks_;             
            std::map<std::string, OutputContextContainer> contextContainers_;   
            OutputContextSubID subcontextCounter_;                              

            bool isInitialized_;                                                
            MemoryWriter*  memoryWriterInstance_;                               
            ConsoleWriter* consoleWriterInstance_;                              
            LogWriter*     logWriterInstance_;                                  

        public:
            struct _UtilExport Testing
            {
                static std::shared_ptr<OutputManager>& getInstancePointer();
            };
    };
}

#endif /* _OutputManager_H__ */