2 * @file main/GUI/main.cpp
3 * @brief The main eVaf GUI application class
6 * Copyright (c) 2011 Enar Vaikene
8 * This file is part of the eVaf C++ cross-platform application development framework.
10 * This file can be used under the terms of the GNU General Public License
11 * version 3.0 as published by the Free Software Foundation and appearing in
12 * the file LICENSE included in the packaging of this file. Please review the
13 * the following information to ensure the GNU General Public License version
14 * 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
16 * Alternatively, this file may be used in accordance with the Commercial License
17 * Agreement provided with the Software.
21 #include "exithandler.h"
23 //#include "version_p.h"
27 #include "winconsole.h"
30 #include <Common/Globals>
31 #include <Common/iLogger>
32 #include <Common/iEnv>
33 #include <Common/iApp>
35 #include <Plugins/PluginManager>
40 # include <sys/types.h>
45 //-------------------------------------------------------------------
52 * Flag indicating that the application should be more verbose when dealing with fatal errors.
54 * If this flag is set, then shows fatal errors on the screen as dialog boxes and
55 * the user has to close them before terminating the application.
57 * If this flag is not set, then no messages are shown and the application terminates
58 * silently. Error messages are written only into the log file.
60 static bool BeVerbose
= true;
64 * Flag indicating that the application needs a console window.
66 * If this flag is set, opens an extra console window for message output.
68 static bool NeedsConsole
= false;
72 * Console severity level.
74 * This variable is used to set the console severity level. The severity level is changed
75 * with command-line arguments.
77 static eVaf::Common::iLogger::Severity ConsoleSeverityLevel
= eVaf::Common::iLogger::Fatal
;
80 * Qt message handler replacement.
81 * @param type Type of the message
82 * @param msg The message
84 * This function outputs messages to the console and to the log file.
86 static void messageOutput(QtMsgType type
, char const * const msg
)
88 static bool inHandler
= false;
90 // Avoid recursions in case outputting a message causes another message to be output
95 // Qt message type conversion to eVaf logger severity levels
96 eVaf::Common::iLogger::Severity v
;
99 v
= eVaf::Common::iLogger::Warning
;
102 v
= eVaf::Common::iLogger::Error
;
105 v
= eVaf::Common::iLogger::Fatal
;
108 v
= eVaf::Common::iLogger::Debug
;
111 // Output to the log file and console
112 eVaf::Common::iLogger::instance()->write(v
, msg
);
118 * Fatal error message handler
119 * @param msg The error message
120 * @param source Source of the message
121 * @param where Where the error occurred
123 * This function shows a critical error message box on the screen if needed and then terminates
126 * If the critical error message is shown, then the user has an option to ignore the error. In this
127 * case the application is not terminated.
129 static void fatalMsgHandler(QString
const & msg
, QString
const & source
, QString
const & where
)
131 // Show the message on the screen
133 if (FatalErr::message(QObject::tr("Fatal Error"),
134 QObject::tr("%1\n\nOccurred in '%2'")
137 0) == FatalErr::Ignore
)
147 } // namespace eVaf::GUI::Internal
148 } // namespace eVaf::GUI
152 //-------------------------------------------------------------------
154 using namespace eVaf
;
155 using namespace eVaf::GUI
;
157 Application::Application(int & argc
, char ** argv
)
158 : QApplication(argc
, argv
)
160 setObjectName(QString("%1-%2").arg(VER_MODULE_NAME_STR
).arg(__FUNCTION__
));
162 EVAF_INFO("%s version %s created", qPrintable(objectName()), VER_FILE_VERSION_STR
);
165 Application::~Application()
167 EVAF_INFO("%s destroyed", qPrintable(objectName()));
170 bool Application::processCommandLine(int argc
, char ** argv
)
173 for (int i
= 1; i
< argc
; ++i
)
176 for (int i
= 0; i
< args
.size(); ++i
) {
177 // Get the argument and optional value
178 QStringList arg
= args
.at(i
).simplified().split(QChar('='));
180 if (QRegExp("(-[-]?version)|([-//]V)").exactMatch(arg
.at(0))) {
184 else if (QRegExp("(-[-]?help)|([-//][h/?])").exactMatch(arg
.at(0))) {
188 else if (QRegExp("-[-]?help-qt").exactMatch(arg
.at(0))) {
192 else if (QRegExp("-[-]?verbose").exactMatch(arg
.at(0)) && arg
.size() > 1) {
194 Internal::NeedsConsole
= true;
196 QString v
= arg
.at(1).toLower();
198 Internal::ConsoleSeverityLevel
= Common::iLogger::Debug
;
199 else if (v
== "info")
200 Internal::ConsoleSeverityLevel
= Common::iLogger::Info
;
201 else if (v
== "warning")
202 Internal::ConsoleSeverityLevel
= Common::iLogger::Warning
;
203 else if (v
== "error")
204 Internal::ConsoleSeverityLevel
= Common::iLogger::Error
;
205 else if (v
== "fatal")
206 Internal::ConsoleSeverityLevel
= Common::iLogger::Fatal
;
207 else if (v
== "none") {
208 Internal::ConsoleSeverityLevel
= Common::iLogger::None
;
209 Internal::BeVerbose
= false;
211 Internal::NeedsConsole
= false;
219 else if (QRegExp("-[v]+").exactMatch(arg
.at(0)) && arg
.size() == 1) {
220 // The number of 'v's increases the verbosity
221 for (int j
= 1; j
< arg
.at(0).size(); ++j
) {
222 switch (Internal::ConsoleSeverityLevel
) {
223 case Common::iLogger::None
:
224 Internal::ConsoleSeverityLevel
= Common::iLogger::Fatal
;
226 case Common::iLogger::Fatal
:
227 Internal::ConsoleSeverityLevel
= Common::iLogger::Error
;
229 case Common::iLogger::Error
:
230 Internal::ConsoleSeverityLevel
= Common::iLogger::Warning
;
232 case Common::iLogger::Warning
:
233 Internal::ConsoleSeverityLevel
= Common::iLogger::Info
;
235 case Common::iLogger::Info
:
236 Internal::ConsoleSeverityLevel
= Common::iLogger::Debug
;
238 case Common::iLogger::Debug
:
248 void Application::printHelp()
250 char const * const txt
= QT_TR_NOOP(
251 "Usage: eVafGUI [options]\n"
254 " -help Shows this help and quits.\n"
255 " -help-qt Shows Qt command line options and quits.\n"
256 " -version Shows version information and quits.\n"
257 " -verbose=LEVEL Specifies the verbose level. LEVEL can be one of the\n"
258 " following: NONE, FATAL, ERROR, WARNING, INFO, DEBUG.\n"
259 " -v Makes the application more verbose. Can be repeated for\n"
261 // Handled by the iApp interface implementation
262 " -appl[ication]=NAME Specifies the name of the application.\n"
263 " -lang[uage]=xx[_CC] Specifies the language, where xx is the ISO 639\n"
264 " language code followed by an optional ISO 3166 country\n"
266 // Handled by the iEnv interface implementation
267 " -root[dir]=DIR Specifies the application's root directory.\n"
268 " -dataroot[dir]=DIR Specifies the data root directory.\n"
269 " -etc[dir]=DIR Specifies the configuration files directory.\n"
270 " -log[dir]=DIR Specifies the log files directory.\n"
271 " -doc[dir]=DIR Specifies the documentation directory.\n"
272 " -qtplugins[dir]=DIR Specifies the Qt plugins directory.\n"
274 ::fputs(tr(txt
).toLocal8Bit().constData(), stdout
);
277 void Application::printQtHelp()
279 // Cannot translate this text as QT_TR_NOOP() is not able to process #ifdef parts.
280 char const * const txt
=
282 "Qt debugging options:\n"
283 " -nograb tells Qt that it must never grab the mouse or the keyboard.\n"
285 " -dograb running under a debugger can cause an implicit -nograb,\n"
286 " use -dograb to override.\n"
287 " -sync switches to synchronous mode for debugging.\n\n"
290 "Qt common options:\n"
291 " -style=STYLE sets the application GUI style. Possible values are motif,\n"
292 " windows, and platinum.\n"
293 " -style STYLE is the same as listed above.\n"
294 " -stylesheet=STYLESHEET sets the application style sheet.\n"
295 " -stylesheet STYLESHEET is the same as listed above.\n"
296 " -session=SESSION restores the application from an earlier session.\n"
297 " -session SESSION is the same as listed above.\n"
298 " -widgetcount prints debug message at the end about number of widgets\n"
299 " left undestroyed and maximum number of widgets existed at\n"
301 " -reverse sets the application's layout direction to Qt::RightToLeft\n\n"
303 "Qt options on Windows:\n"
304 " -direct3d will make the Direct3D paint engine the default widget\n"
305 " paint engine in Qt.\n\n"
308 "Qt options on X11:\n"
309 " -display DISPLAY sets the X display.\n"
310 " -geometry GEOMETRY sets the client geometry of the first window that is\n"
312 " -fn or -font FONT defines the application font.\n"
313 " -bg or -background COLOR sets the default background color and an\n"
314 " application palette.\n"
315 " -fg or -foreground COLOR sets the default foreground color.\n"
316 " -btn or -button COLOR sets the default button color.\n"
317 " -name NAME sets the application name.\n"
318 " -title TITLE sets the application title.\n"
319 " -visual TrueColor forces the application to use a TrueColor visual on an\n"
321 " -ncols COUNT limits the number of colors allocated in the color cube on\n"
322 " an 8-bit display, if the application is using the\n"
323 " QApplication::ManyColor color specification. If COUNT is\n"
324 " 216 then a 6x6x6 color cube is used (i.e. 6 levels of red,\n"
325 " 6 of green, and 6 of blue); for other values, a cube\n"
326 " approximately proportional to a 2x3x1 cube is used.\n"
327 " -cmap causes the application to install a private color map on an\n"
329 " -im sets the input method server (equivalent to setting the\n"
330 " XMODIFIERS environment variable).\n"
331 " -noxim disables the input method framework (\"no X input method\").\n"
332 " -inputstyle defines how the input is inserted into the given widget.\n"
333 " E.g., onTheSpot makes the input appear directly in the\n"
334 " widget, while overTheSpot makes the input appear in a box\n"
335 " floating over the widget and is not inserted until the\n"
336 " editing is done.\n"
339 ::fputs(txt
, stdout
);
342 void Application::printVersion()
344 ::printf("%s version %s release date %s, %s version %s\n",
345 VER_PRODUCT_NAME_STR
,
346 VER_PRODUCT_VERSION_STR
,
347 VER_PRODUCT_DATE_STR
,
354 //-------------------------------------------------------------------
356 int main(int argc
, char ** argv
)
358 Common::iLogger::instance()->setSeverity(Common::iLogger::Warning
);
360 // Install our own message handlers
361 Common::iLogger::instance()->installFatalMsgHandler(Internal::fatalMsgHandler
);
362 qInstallMsgHandler(Internal::messageOutput
);
364 // Process command-line arguments
365 if (!Application::processCommandLine(argc
, argv
))
368 // Set the console severity
369 Common::iLogger::instance()->setConsoleSeverity(Internal::ConsoleSeverityLevel
);
372 // Enable the extra message console on Windows
373 if (Internal::NeedsConsole
)
374 Internal::enableWinConsole();
377 EVAF_INFO("%s version %s release date %s, %s version %s",
378 VER_PRODUCT_NAME_STR
,
379 VER_PRODUCT_VERSION_STR
,
380 VER_PRODUCT_DATE_STR
,
382 VER_FILE_VERSION_STR
);
385 EVAF_INFO("%s application pid = %d", VER_MODULE_NAME_STR
, getpid());
388 Application
app(argc
, argv
);
390 // Install the exit handler
391 if (!Internal::installExitHandler())
395 Plugins::PluginManager pluginManager
;
402 EVAF_INFO("%s is starting up", VER_MODULE_NAME_STR
);
404 // Initialize the common library
408 // Initialize the plugin manager and load plugins
409 if (!pluginManager
.init())
412 // Run the application
413 EVAF_INFO("Running %s", VER_MODULE_NAME_STR
);
416 quit
= rval
!= Common::iApp::RC_Restart
;
418 EVAF_INFO("%s is %s", VER_MODULE_NAME_STR
, quit
? "exiting" : "restarting");
420 // Unload plugins and finalize the plugin manager
421 pluginManager
.done();
424 EVAF_INFO("%s exit with code %d", VER_MODULE_NAME_STR
, rval
);