#include <ILogger.h>
Inheritance diagram for ILogger:
| virtual ~ILogger | ( | ) | [inline, virtual] |
| bool drop | ( | ) | [inline, inherited] |
Drops the object. Decrements the reference counter by one. Returns true, if the object was deleted. The IrrUnknown class provides a basic reference counting mechanism with its methods grab() and drop(). Most objects of the Irrlicht Engine are derived from IrrUnknown, and so they are reference counted.
When you create an object in the Irrlicht engine, calling a method which starts with 'create', an object is created, and you get a pointer to the new object. If you no longer need the object, you have to call drop(). This will destroy the object, if grab() was not called in another part of you program, because this part still needs the object. Note, that you only need to call drop() to the object, if you created it, and the method had a 'create' in it.
A simple example:
If you want to create a texture, you may want to call an imaginable method IDriver::createTexture. You call ITexture* texture = driver->createTexture(dimension2d<s32>(128, 128)); If you no longer need the texture, call texture->drop(). If you want to load a texture, you may want to call imaginable method IDriver::loadTexture. You do this like ITexture* texture = driver->loadTexture("example.jpg"); You will not have to drop the pointer to the loaded texture, because the name of the method does not start with 'create'. The texture is stored somewhere by the driver.
| const c8* getDebugName | ( | ) | const [inline, inherited] |
Returns the debug name of the object. The Debugname may only be set and changed by the object itself. This method should only be used in Debug mode.
| virtual ELOG_LEVEL getLogLevel | ( | ) | [pure virtual] |
Implemented in CLogger.
| void grab | ( | ) | [inline, inherited] |
Grabs the object. Increments the reference counter by one. Someone who calls grab() to an object, should later also call drop() to it. If an object never gets as much drop() as grab() calls, it will never be destroyed. The IrrUnknown class provides a basic reference counting mechanism with its methods grab() and drop(). Most objects of the Irrlicht Engine are derived from IrrUnknown, and so they are reference counted.
When you create an object in the Irrlicht engine, calling a method which starts with 'create', an object is created, and you get a pointer to the new object. If you no longer need the object, you have to call drop(). This will destroy the object, if grab() was not called in another part of you program, because this part still needs the object. Note, that you only need to call drop() to the object, if you created it, and the method had a 'create' in it.
A simple example:
If you want to create a texture, you may want to call an imaginable method IDriver::createTexture. You call ITexture* texture = driver->createTexture(dimension2d<s32>(128, 128)); If you no longer need the texture, call texture->drop(). If you want to load a texture, you may want to call imaginable method IDriver::loadTexture. You do this like ITexture* texture = driver->loadTexture("example.jpg"); You will not have to drop the pointer to the loaded texture, because the name of the method does not start with 'create'. The texture is stored somewhere by the driver.
| virtual void log | ( | const c8 * | message, | |
| const core::plane3df & | p | |||
| ) | [pure virtual] |
Implemented in CLogger.
| virtual void log | ( | const c8 * | message, | |
| const core::vector3df & | v | |||
| ) | [pure virtual] |
Implemented in CLogger.
| virtual void log | ( | const c8 * | message, | |
| const core::matrix4 & | m | |||
| ) | [pure virtual] |
Implemented in CLogger.
| virtual void log | ( | const wchar_t * | text, | |
| ELOG_LEVEL | ll = ELL_INFORMATION | |||
| ) | [pure virtual] |
Prints out a text into the log
| text,: | Text to print out. | |
| 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. |
Implemented in CLogger.
| virtual void log | ( | const wchar_t * | text, | |
| const wchar_t * | hint, | |||
| ELOG_LEVEL | ll = ELL_INFORMATION | |||
| ) | [pure virtual] |
Prints out a text into the log
| text,: | Text to print out. | |
| hint,: | Additional info. This string is added after a " :" to the string. | |
| 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. |
Implemented in CLogger.
| virtual void log | ( | const c8 * | text, | |
| const c8 * | hint, | |||
| ELOG_LEVEL | ll = ELL_INFORMATION | |||
| ) | [pure virtual] |
Prints out a text into the log
| text,: | Text to print out. | |
| hint,: | Additional info. This string is added after a " :" to the string. | |
| 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. |
Implemented in CLogger.
| virtual void log | ( | const c8 * | text, | |
| ELOG_LEVEL | ll = ELL_INFORMATION | |||
| ) | [pure virtual] |
Prints out a text into the log
| text,: | Text to print out. | |
| 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. |
Implemented in CLogger.
| void setDebugName | ( | const c8 * | newName | ) | [inline, protected, inherited] |
Sets the debug name of the object. The Debugname may only be set and changed by the object itself. This method should only be used in Debug mode.
| newName,: | New debug name to set. |
| virtual void setLogLevel | ( | ELOG_LEVEL | ll | ) | [pure virtual] |
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.
| ll,: | new log level filter value. |
Implemented in CLogger.
1.5.1-p1