mirror of
https://github.com/minetest/irrlicht.git
synced 2024-09-18 02:10:43 +02:00
0c6385cb92
Usually something like __IRR_SOME_GUARD_INCLUDED__ replaced by IRR_SOME_GUARD_INCLUDED. Removing underscores at the end wasn't necessary, but more symmetric (probably the reason they got added there as well). While this touches every header it shouldn't affect users (I hope). Also a few whitespace changes to unify whitespace usage a bit. And a bunch of spelling fixes in comments. git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/trunk@6252 dfc29bdd-3216-0410-991c-e03cc46cb475
102 lines
3.9 KiB
C++
102 lines
3.9 KiB
C++
// Copyright (C) 2002-2012 Nikolaus Gebhardt
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#ifndef IRR_I_LOGGER_H_INCLUDED
|
|
#define IRR_I_LOGGER_H_INCLUDED
|
|
|
|
#include "IReferenceCounted.h"
|
|
|
|
namespace irr
|
|
{
|
|
|
|
//! Possible log levels.
|
|
//! When used has filter ELL_DEBUG means => log everything and ELL_NONE means => log (nearly) nothing.
|
|
//! When used to print logging information ELL_DEBUG will have lowest priority while ELL_NONE
|
|
//! messages are never filtered and always printed.
|
|
enum ELOG_LEVEL
|
|
{
|
|
//! Used for printing information helpful in debugging
|
|
ELL_DEBUG,
|
|
|
|
//! Useful information to print. For example hardware infos or something started/stopped.
|
|
ELL_INFORMATION,
|
|
|
|
//! Warnings that something isn't as expected and can cause oddities
|
|
ELL_WARNING,
|
|
|
|
//! Something did go wrong.
|
|
ELL_ERROR,
|
|
|
|
//! Logs with ELL_NONE will never be filtered.
|
|
//! And used as filter it will remove all logging except ELL_NONE messages.
|
|
ELL_NONE
|
|
};
|
|
|
|
|
|
//! Interface for logging messages, warnings and errors
|
|
class ILogger : public virtual IReferenceCounted
|
|
{
|
|
public:
|
|
|
|
//! Destructor
|
|
virtual ~ILogger() {}
|
|
|
|
//! Returns the current set log level.
|
|
virtual ELOG_LEVEL getLogLevel() const = 0;
|
|
|
|
//! Sets a new log level.
|
|
/** With this value, texts which are sent to the logger are filtered
|
|
out. For example setting this value to ELL_WARNING, only warnings and
|
|
errors are printed out. Setting it to ELL_INFORMATION, which is the
|
|
default setting, warnings, errors and informational texts are printed
|
|
out.
|
|
\param ll: new log level filter value. */
|
|
virtual void setLogLevel(ELOG_LEVEL ll) = 0;
|
|
|
|
//! Prints out a text into the log
|
|
/** \param text: Text to print out.
|
|
\param ll: Log level of the text. If the text is an error, set
|
|
it to ELL_ERROR, if it is warning set it to ELL_WARNING, and if it
|
|
is just an informational text, set it to ELL_INFORMATION. Texts are
|
|
filtered with these levels. If you want to be a text displayed,
|
|
independent on what level filter is set, use ELL_NONE. */
|
|
virtual void log(const c8* text, ELOG_LEVEL ll=ELL_INFORMATION) = 0;
|
|
|
|
//! Prints out a text into the log
|
|
/** \param text: Text to print out.
|
|
\param hint: Additional info. This string is added after a " :" to the
|
|
string.
|
|
\param ll: Log level of the text. If the text is an error, set
|
|
it to ELL_ERROR, if it is warning set it to ELL_WARNING, and if it
|
|
is just an informational text, set it to ELL_INFORMATION. Texts are
|
|
filtered with these levels. If you want to be a text displayed,
|
|
independent on what level filter is set, use ELL_NONE. */
|
|
virtual void log(const c8* text, const c8* hint, ELOG_LEVEL ll=ELL_INFORMATION) = 0;
|
|
virtual void log(const c8* text, const wchar_t* hint, ELOG_LEVEL ll=ELL_INFORMATION) = 0;
|
|
|
|
//! Prints out a text into the log
|
|
/** \param text: Text to print out.
|
|
\param hint: Additional info. This string is added after a " :" to the
|
|
string.
|
|
\param ll: Log level of the text. If the text is an error, set
|
|
it to ELL_ERROR, if it is warning set it to ELL_WARNING, and if it
|
|
is just an informational text, set it to ELL_INFORMATION. Texts are
|
|
filtered with these levels. If you want to be a text displayed,
|
|
independent on what level filter is set, use ELL_NONE. */
|
|
virtual void log(const wchar_t* text, const wchar_t* hint, ELOG_LEVEL ll=ELL_INFORMATION) = 0;
|
|
|
|
//! Prints out a text into the log
|
|
/** \param text: Text to print out.
|
|
\param ll: Log level of the text. If the text is an error, set
|
|
it to ELL_ERROR, if it is warning set it to ELL_WARNING, and if it
|
|
is just an informational text, set it to ELL_INFORMATION. Texts are
|
|
filtered with these levels. If you want to be a text displayed,
|
|
independent on what level filter is set, use ELL_NONE. */
|
|
virtual void log(const wchar_t* text, ELOG_LEVEL ll=ELL_INFORMATION) = 0;
|
|
};
|
|
|
|
} // end namespace
|
|
|
|
#endif
|