LoggingInterface.hh 6.88 KB
 Jan Möbius committed Aug 05, 2009 1 /*===========================================================================*\  Jan Möbius committed Nov 25, 2010 2 3 * * * OpenFlipper *  Jan Möbius committed Jan 26, 2011 4 * Copyright (C) 2001-2011 by Computer Graphics Group, RWTH Aachen *  Jan Möbius committed Nov 25, 2010 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 * www.openflipper.org * * * *--------------------------------------------------------------------------- * * This file is part of OpenFlipper. * * * * OpenFlipper is free software: you can redistribute it and/or modify * * it under the terms of the GNU Lesser General Public License as * * published by the Free Software Foundation, either version 3 of * * the License, or (at your option) any later version with the * * following exceptions: * * * * If other files instantiate templates or use macros * * or inline functions from this file, or you compile this file and * * link it with other files to produce an executable, this file does * * not by itself cause the resulting executable to be covered by the * * GNU Lesser General Public License. This exception does not however * * invalidate any other reasons why the executable file might be * * covered by the GNU Lesser General Public License. * * * * OpenFlipper 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 Lesser General Public License for more details. * * * * You should have received a copy of the GNU LesserGeneral Public * * License along with OpenFlipper. If not, * * see . * * *  Jan Möbius committed Aug 05, 2009 33 34 35 \*===========================================================================*/ /*===========================================================================*\  Jan Möbius committed Nov 25, 2010 36 37 38 39 40 * * * $Revision$ * * $LastChangedBy$ * * $Date$ * * *  Jan Möbius committed Aug 05, 2009 41 \*===========================================================================*/  Jan Möbius committed Aug 29, 2008 42 43 44 45 46 47  #ifndef LOGGINGINTERFACE_HH #define LOGGINGINTERFACE_HH  Jan Möbius committed Feb 22, 2011 48 49 50 51 52 53 /** \file LoggingInterface.hh * * Interface for sending log messages to the log widget.\ref */ /** \page loggingInterfacePage Logging Interface  Jan Möbius committed Feb 22, 2011 54 \image html LoggingInterface.png  Jan Möbius committed Feb 22, 2011 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 The Logging interface can be used by plugins to print messages in OpenFlippers log widget below the gl viewer (See image). The log widget can apply filters to visualize only the messages of a certain importance. The widget has 3 different modes, which can be toggled by pressing Ctrl + L:
• Docked automatic mode: In this mode the widget is at the bottom and will hide itself if not used.
• Docked mode: The widget is always visible and docked at the bottom
• Undocked: The widget is undocked into a separate window
The message importance level can be specified by the Logtype enum. There are four different levels which describe the importance and are represented by different colors in the log widget.
• Out: Simple output messages in black
• Info: Information messages printed in green
• Warn: Warnings in yellow
• Errors: Error messages printed in red
To use the LoggingInterface:
• include LoggingInterface.hh in your plugins header file
• derive your plugin from the class LoggingInterface  Jan Möbius committed Feb 22, 2011 77 
• add Q_INTERFACES(LoggingInterface) to your plugin class  Jan Möbius committed Feb 22, 2011 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 
• And add the signals or slots you want to use to your plugin class (You don't need to implement all of them)
If you use the interface, all messages printed from that plugin will be prepended with the name of the plugin to identify the origin of the message.\n The following code sends a log message \code emit log(LOGERR,tr("Error message")); \endcode */ /** \brief Log types for Message Window * * Use this enum to specify the importance of log messages. */ enum Logtype { LOGOUT , /*!< Standard log messages. Will be printed in black in the logwidget */ LOGINFO , /*!< Info log messages. Will be printed in green in the logwidget */ LOGWARN , /*!< Warning messages. Will be printed in yellow in the logwidget */ LOGERR /*!< Error messages. Will be printed in red in the logwidget */ };  Jan Möbius committed Aug 29, 2008 99 100 101  /** \brief Interface for all Plugins which do logging to the logging window of the framework *  Jan Möbius committed Feb 22, 2011 102 103  * \ref loggingInterfacePage "Detailed description" * \n  Jan Möbius committed Aug 29, 2008 104  * By emitting the given signals you can log information to the main logger window of the core.  Jan Möbius committed Feb 22, 2011 105  * To simplify debugging, the core will prepend the plugin name to every log message. You dont  Jan Möbius committed Aug 29, 2008 106  * have to do this yourself!\n  Mike Kremer committed Mar 26, 2009 107 108  * The log message will either be black or will be colored depending on the Logtype you specified. *  Jan Möbius committed Feb 22, 2011 109 110  * A more detailed description of the LoggingInterface can be found \ref loggingInterfacePage "here" or * read our tutorials \ref ex2 and \ref ex3 for an example of how to use logging output.  Jan Möbius committed Aug 29, 2008 111 112 113 114  */ class LoggingInterface { signals :  Jan Möbius committed Feb 24, 2011 115 116  /** Send a log message to the mainwindow of the widget *  Jan Möbius committed Aug 29, 2008 117 118 119  * @param _type Message type (LOGINFO,LOGOUT,LOGWARN,LOGERR) * @param _message Message to be displayed */  Jan Möbius committed Feb 24, 2011 120  virtual void log(Logtype _type, QString _message) = 0;  Jan Möbius committed Aug 29, 2008 121 122 123  /** Send a log message to the mainwindow of the widget \n * defaults to LOGOUT message type  Jan Möbius committed Feb 24, 2011 124  *  Jan Möbius committed Aug 29, 2008 125 126  * @param _message Message to be displayed */  Jan Möbius committed Feb 24, 2011 127  virtual void log(QString _message) = 0;  Jan Möbius committed Aug 29, 2008 128 129 130 131  private slots: /** Through this slot you can receive all logging information emitted by OpenFlipper  Jan Möbius committed Feb 24, 2011 132 133 134 135 136 137  * or one of its plugins * * @param _type Message type * @param _message Message */ virtual void logOutput( Logtype _type , QString _message ) {};  Mike Kremer committed Feb 10, 2009 138 139 140 141 142  public: /// Destructor virtual ~LoggingInterface() {};  Jan Möbius committed Aug 29, 2008 143 144 145 146 147 }; Q_DECLARE_INTERFACE(LoggingInterface,"OpenFlipper.LoggingInterface/1.0") #endif // LOGGINGINTERFACE_HH