Assimp
v3.0 (July 2012)
|
CPP-API: Primary logging facility of Assimp. More...
Inherits Assimp::Logger.
Public Member Functions | |
bool | attachStream (LogStream *pStream, unsigned int severity) |
Attach a new log-stream. | |
bool | detatchStream (LogStream *pStream, unsigned int severity) |
Detach a still attached stream from the logger (or modify the filter flags bits) | |
Public Member Functions inherited from Assimp::Logger | |
void | debug (const char *message) |
Writes a debug message. | |
void | debug (const std::string &message) |
void | error (const char *message) |
Writes an error message. | |
void | error (const std::string &message) |
LogSeverity | getLogSeverity () const |
Get the current log severity. | |
void | info (const char *message) |
Writes a info message. | |
void | info (const std::string &message) |
void | setLogSeverity (LogSeverity log_severity) |
Set a new log severity. | |
void | warn (const char *message) |
Writes a warning message. | |
void | warn (const std::string &message) |
virtual | ~Logger () |
Virtual destructor. |
Static Public Member Functions | |
static Logger * | create (const char *name=ASSIMP_DEFAULT_LOG_NAME, LogSeverity severity=NORMAL, unsigned int defStreams=aiDefaultLogStream_DEBUGGER|aiDefaultLogStream_FILE, IOSystem *io=NULL) |
Creates a logging instance. | |
static Logger * | get () |
Getter for singleton instance. | |
static bool | isNullLogger () |
Return whether a #NullLogger is currently active. | |
static void | kill () |
Kills the current singleton logger and replaces it with a #NullLogger instance. | |
static void | set (Logger *logger) |
Setup a custom Logger implementation. |
Additional Inherited Members | |
Public Types inherited from Assimp::Logger | |
enum | ErrorSeverity { Debugging = 1, Info = 2, Warn = 4, Err = 8 } |
Description for severity of a log message. More... | |
enum | LogSeverity { NORMAL, VERBOSE } |
Log severity to describe the granularity of logging. More... | |
Protected Member Functions inherited from Assimp::Logger | |
Logger () | |
Default constructor. | |
Logger (LogSeverity severity) | |
Construction with a given log severity. | |
Protected Attributes inherited from Assimp::Logger | |
LogSeverity | m_Severity |
Logger severity. |
CPP-API: Primary logging facility of Assimp.
The library stores its primary Logger as a static member of this class. get() returns this primary logger. By default the underlying implementation is just a #NullLogger which rejects all log messages. By calling create(), logging is turned on. To capture the log output multiple log streams (#LogStream) can be attach to the logger. Some default streams for common streaming locations (such as a file, std::cout, OutputDebugString()) are also provided.
If you wish to customize the logging at an even deeper level supply your own implementation of Logger to set().
|
virtual |
Attach a new log-stream.
The logger takes ownership of the stream and is responsible for its destruction (which is done using ::delete when the logger itself is destroyed). Call detachStream to detach a stream and to gain ownership of it again.
pStream | Log-stream to attach |
severity | Message filter, specified which types of log messages are dispatched to the stream. Provide a bitwise combination of the ErrorSeverity flags. |
Implements Assimp::Logger.
|
static |
Creates a logging instance.
name | Name for log file. Only valid in combination with the aiDefaultLogStream_FILE flag. |
severity | Log severity, VERBOSE turns on debug messages |
defStreams | Default log streams to be attached. Any bitwise combination of the aiDefaultLogStream enumerated values. If #aiDefaultLogStream_FILE is specified but an empty string is passed for 'name', no log file is created at all. |
io | IOSystem to be used to open external files (such as the log file). Pass NULL to rely on the default implementation. This replaces the default #NullLogger with a #DefaultLogger instance. |
|
virtual |
Detach a still attached stream from the logger (or modify the filter flags bits)
@param pStream Log-stream instance for detaching
severity | Provide a bitwise combination of the ErrorSeverity flags. This value is &~ed with the current flags of the stream, if the result is 0 the stream is detached from the Logger and the caller retakes the possession of the stream. |
Implements Assimp::Logger.
|
static |
Getter for singleton instance.
@return Only instance. This is never null, but it could be a
NullLogger. Use isNullLogger to check this.
|
static |
|
static |
Kills the current singleton logger and replaces it with a #NullLogger instance.
|
static |
Setup a custom Logger implementation.
Use this if the provided #DefaultLogger class doesn't fit into your needs. If the provided message formatting is OK for you, it's much easier to use create() and to attach your own custom output streams to it.
logger | Pass NULL to setup a default NullLogger |