The ILogger interface class supports logging of messages. More...
#include <ilogger.h>
Public Member Functions | |
| virtual void | message (Message_severity level, const char *module_category, const char *message) |
| Emits a message to the application's log. More... | |
| virtual void | message (Message_severity level, const char *module_category, const Message_details &, const char *message)=0 |
| Emits a message to the application's log. More... | |
| void | printf (Message_severity level, const char *module_category, const char *message,...) __attribute__((format(printf |
| Emits a message to the application's log. More... | |
| void | printf (Message_severity level, const char *module_category, const Message_details &details, const char *message,...) __attribute__((format(printf |
| Emits a message to the application's log. More... | |
 Public Member Functions inherited from mi::base::IInterface | |
| virtual Uint32 | retain () const =0 |
| Increments the reference count. More... | |
| virtual Uint32 | release () const =0 |
| Decrements the reference count. More... | |
| virtual const IInterface * | get_interface (const Uuid &interface_id) const =0 |
| Acquires a const interface from another. More... | |
| template<class T> | |
| const T * | get_interface () const |
| Acquires a const interface from another. More... | |
| virtual IInterface * | get_interface (const Uuid &interface_id)=0 |
| Acquires a mutable interface from another. More... | |
| template<class T> | |
| T * | get_interface () |
| Acquires a mutable interface from another. More... | |
| virtual Uuid | get_iid () const =0 |
| Returns the interface ID of the most derived interface. More... | |
Additional Inherited Members | |
| Public Types inherited from mi::base::Interface_declare< 0x4afbf19a, ... > | |
| typedef Interface_declare< id1, ... > | Self |
| Own type. More... | |
| typedef Uuid_t< id1, ... > | IID |
| Declares the interface ID (IID) of this interface. More... | |
| Public Types inherited from mi::base::IInterface | |
| typedef Uuid_t<0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0> | IID |
| Declares the interface ID (IID) of this interface. More... | |
| Static Public Member Functions inherited from mi::base::Interface_declare< 0x4afbf19a, ... > | |
| static bool | compare_iid (const Uuid &iid) |
Compares the interface ID iid against the interface ID of this interface and of its ancestors. More... | |
| Static Public Member Functions inherited from mi::base::IInterface | |
| static bool | compare_iid (const Uuid &iid) |
Compares the interface ID iid against the interface ID of this interface. More... | |
The ILogger interface class supports logging of messages.
Plugins based on mi::base::Plugin are provided with a logger, such that plugins can be written to use the same message log as the host application.
Different APIs allow to register your own implementation of a logger to override their internal implementation. Note that in such case the object implementing this interface shall not be created on the stack, since this might lead to premature destruction of such instances while still being in use by the API.
The following message categories are used in some APIs. There might be other, undocumented categories.
| category | purpose |
|---|---|
| "DATABASE" | database |
| "DISK" | raw disk I/O, swapping |
| "GEOMETRY" | geometry processing, e.g., tessellation |
| "IMAGE" | texture processing, image and video plugins |
| "IO" | scene data import and export |
| "MAIN" | reserved for the application itself |
| "MISC" | other |
| "MEMORY" | memory management |
| "NETWORK" | networking |
| "PLUGIN" | plugins (unless other categories fit better) |
| "RENDER" | rendering |
