new home directory
[feisty_meow.git] / nucleus / library / application / hoople_main.h
1 #ifndef HOOPLE_MAIN_GROUP
2 #define HOOPLE_MAIN_GROUP
3
4 /*****************************************************************************\
5 *                                                                             *
6 *  Name   : HOOPLE_MAIN group
7 *  Author : Chris Koeritz
8 *                                                                             *
9 *******************************************************************************
10 * Copyright (c) 2000-$now By Author.  This program is free software; you can  *
11 * redistribute it and/or modify it under the terms of the GNU General Public  *
12 * License as published by the Free Software Foundation; either version 2 of   *
13 * the License or (at your option) any later version.  This is online at:      *
14 *     http://www.fsf.org/copyleft/gpl.html                                    *
15 * Please send any updates to: fred@gruntose.com                               *
16 \*****************************************************************************/
17
18 //! @file "hoople_main.h" Provides macros that implement the 'main' program of an application.
19
20 #include "application_shell.h"
21 #include "command_line.h"
22 #include "windoze_helper.h"
23
24 #include <basis/contracts.h>
25 #include <loggers/critical_events.h>
26 #include <loggers/combo_logger.h>
27 #include <structures/static_memory_gremlin.h>
28 #include <loggers/program_wide_logger.h>
29
30 namespace application {
31
32 // The following versions of main programs are provided for different operating
33 // systems and compilation environments.  These support the requirements of the
34 // HOOPLE startup code and program-wide features, assuming an object derived
35 // from base_application is available.
36 // The object derived from base_application must be provided in "obj_name".
37 // The "obj_args" are any arguments that need to be passed to the object's
38 // constructor; this list can be empty.
39 // Note that the default logger used for unix and console mode win32 programs
40 // is the console logger; that can be changed in the startup code for the
41 // "obj_name".
42
43 #define HOOPLE_STARTUP_CODE \
44   DEFINE_INSTANCE_HANDLE;
45
46 #ifdef __WXWIDGETS__
47   //! main program for applications using WxWidgets library.
48   #define HOOPLE_MAIN(obj_name, obj_args) \
49     HOOPLE_STARTUP_CODE; \
50     int main(int argc, char *argv[]) { \
51       SET_ARGC_ARGV(argc, argv); \
52       SETUP_COMBO_LOGGER; \
53       obj_name to_run_obj obj_args; \
54       return to_run_obj.execute_application(); \
55     }
56
57 //////////////
58
59 #elif defined(__UNIX__) || defined(__GNU_WINDOWS__)
60   //! options that should work for most unix and linux apps.
61   #define HOOPLE_MAIN(obj_name, obj_args) \
62     HOOPLE_STARTUP_CODE; \
63     int main(int argc, char *argv[]) { \
64       SET_ARGC_ARGV(argc, argv); \
65       SETUP_COMBO_LOGGER; \
66       obj_name to_run_obj obj_args; \
67       return to_run_obj.execute_application(); \
68     }
69
70 //////////////
71
72 #elif defined(_MSC_VER)
73   // for win32 we need to support four different environments--console mode,
74   // borland compilation, MFC programs and regular windows programs.
75   #ifdef _CONSOLE
76     //! console mode programs can easily write to a command shell.
77     #define HOOPLE_MAIN(obj_name, obj_args) \
78       HOOPLE_STARTUP_CODE; \
79       int main(int argc, char *argv[]) { \
80         SET_ARGC_ARGV(argc, argv); \
81         SETUP_COMBO_LOGGER; \
82         obj_name to_run_obj obj_args; \
83         return to_run_obj.execute_application(); \
84       }
85   #elif defined(_AFXDLL)
86     //! MFC applications generally use a tiny shell which hooks up logging.
87     #define HOOPLE_MAIN(obj_name, obj_args)  \
88       HOOPLE_STARTUP_CODE; \
89       SET_ARGC_ARGV(__argc, __argv); \
90       tiny_application<obj_name> theApp;
91   #elif defined(__WIN32__)
92     //! standard win32 applications have no console, so we just log to a file.
93     #define HOOPLE_MAIN(obj_name, obj_args)  \
94       HOOPLE_STARTUP_CODE; \
95       int WINAPI WinMain(application_instance instance, \
96           application_instance prev_instance, LPSTR lpCmdLine, \
97           int nCmdShow) { \
98         SET_ARGC_ARGV(__argc, __argv); \
99         SET_INSTANCE_HANDLE(instance); \
100         SETUP_FILE_LOGGER; \
101         obj_name to_run_obj obj_args; \
102         return to_run_obj.execute_application(); \
103       }
104   #endif
105
106 //////////////
107
108 #else  // not __UNIX__ or __WIN32__
109   //! just guessing this might work; otherwise we have no idea.
110   #define HOOPLE_MAIN(obj_name, obj_args)  \
111     HOOPLE_STARTUP_CODE; \
112     int main(int argc, char *argv[]) { \
113       SETUP_CONSOLE_LOGGER; \
114       obj_name to_run_obj obj_args; \
115       return to_run_obj.execute_application(); \
116     }
117 #endif
118
119 } //namespace.
120
121 #endif // outer guard.
122