cstool/initapp.h
Go to the documentation of this file.00001 /* 00002 Copyright (C) 1998-2001 by Jorrit Tyberghein 00003 00004 This library is free software; you can redistribute it and/or 00005 modify it under the terms of the GNU Library General Public 00006 License as published by the Free Software Foundation; either 00007 version 2 of the License, or (at your option) any later version. 00008 00009 This library is distributed in the hope that it will be useful, 00010 but WITHOUT ANY WARRANTY; without even the implied warranty of 00011 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00012 Library General Public License for more details. 00013 00014 You should have received a copy of the GNU Library General Public 00015 License along with this library; if not, write to the Free 00016 Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 00017 */ 00018 00019 #ifndef __CS_INITAPP_H__ 00020 #define __CS_INITAPP_H__ 00021 00030 #include "csextern.h" 00031 00032 #include "csutil/array.h" 00033 #include "csutil/eventnames.h" 00034 #include "csutil/csstring.h" 00035 #include "csutil/scf.h" 00036 #include "iengine/engine.h" 00037 #include "igraphic/imageio.h" 00038 #include "imap/loader.h" 00039 #include "imap/saver.h" 00040 #include "iutil/evdefs.h" 00041 #include "iutil/vfs.h" 00042 #include "iutil/objreg.h" 00043 #include "iutil/plugin.h" 00044 #include "ivaria/conout.h" 00045 #include "ivaria/reporter.h" 00046 #include "ivaria/stdrep.h" 00047 #include "ivideo/graph3d.h" 00048 #include "ivideo/fontserv.h" 00049 00050 struct iObjectRegistry; 00051 struct iEvent; 00052 struct iEventHandler; 00053 struct iEventQueue; 00054 struct iPluginManager; 00055 struct iVirtualClock; 00056 struct iCommandLineParser; 00057 struct iConfigManager; 00058 struct iSystemOpenManager; 00059 struct iVerbosityManager; 00060 00064 00065 #define CS_REQUEST_PLUGIN(Name,Interface) \ 00066 Name, scfInterfaceTraits<Interface>::GetName(), \ 00067 scfInterfaceTraits<Interface>::GetID(), \ 00068 scfInterfaceTraits<Interface>::GetVersion() 00070 #define CS_REQUEST_PLUGIN_TAG(Name,Interface,Tag) \ 00071 Name ":" Tag , scfInterfaceTraits<Interface>::GetName(), \ 00072 scfInterfaceTraits<Interface>::GetID(), \ 00073 scfInterfaceTraits<Interface>::GetVersion() 00074 00075 // !!! NOTE !!! 00076 // When editing this list, you *must* ensure that initapp.h #include the 00077 // appropriate header for each SCF interface mentioned by a CS_REQUEST_PLUGIN() 00078 // invocation. This is necessary to guarantee that the interface-specialized 00079 // version of scfInterfaceTraits<> is seen by clients rather than the non-specialized 00080 // template. 00081 00083 #define CS_REQUEST_END \ 00084 (const char*)0 00086 #define CS_REQUEST_VFS \ 00087 CS_REQUEST_PLUGIN("crystalspace.kernel.vfs", iVFS) 00089 #define CS_REQUEST_FONTSERVER \ 00090 CS_REQUEST_PLUGIN("crystalspace.font.server.multiplexer", iFontServer) 00092 #define CS_REQUEST_IMAGELOADER \ 00093 CS_REQUEST_PLUGIN("crystalspace.graphic.image.io.multiplexer", iImageIO) 00095 #define CS_REQUEST_NULL3D \ 00096 CS_REQUEST_PLUGIN("crystalspace.graphics3d.null",iGraphics3D) 00098 #define CS_REQUEST_SOFTWARE3D \ 00099 CS_REQUEST_PLUGIN("crystalspace.graphics3d.software",iGraphics3D) 00101 #define CS_REQUEST_OPENGL3D \ 00102 CS_REQUEST_PLUGIN("crystalspace.graphics3d.opengl", iGraphics3D) 00104 #define CS_REQUEST_ENGINE \ 00105 CS_REQUEST_PLUGIN("crystalspace.engine.3d", iEngine) 00107 #define CS_REQUEST_LEVELLOADER \ 00108 CS_REQUEST_PLUGIN("crystalspace.level.loader", iLoader) 00110 #define CS_REQUEST_LEVELSAVER \ 00111 CS_REQUEST_PLUGIN("crystalspace.level.saver", iSaver) 00113 #define CS_REQUEST_REPORTER \ 00114 CS_REQUEST_PLUGIN("crystalspace.utilities.reporter", iReporter) 00116 #define CS_REQUEST_REPORTERLISTENER \ 00117 CS_REQUEST_PLUGIN("crystalspace.utilities.stdrep", iStandardReporterListener) 00119 #define CS_REQUEST_CONSOLEOUT \ 00120 CS_REQUEST_PLUGIN("crystalspace.console.output.standard", iConsoleOutput) 00122 #define CS_REQUEST_JOYSTICK \ 00123 CS_REQUEST_PLUGIN("crystalspace.device.joystick", iEventPlug) 00124 00129 typedef bool (*csEventHandlerFunc) (iEvent&); 00130 00141 class CS_CRYSTALSPACE_EXPORT csPluginRequest 00142 { 00143 private: 00144 csString class_name; 00145 csString interface_name; 00146 scfInterfaceID interface_id; 00147 int interface_version; 00148 void set(csPluginRequest const&); 00149 public: 00150 csPluginRequest(csString class_name, csString interface_name, 00151 scfInterfaceID interface_id, int interface_version); 00152 csPluginRequest(csPluginRequest const& r) { set(r); } 00153 csPluginRequest& operator=(csPluginRequest const& r) {set(r); return *this;} 00154 bool operator==(csPluginRequest const&) const; 00155 bool operator!=(csPluginRequest const& r) const { return !operator==(r); } 00156 csString GetClassName() const { return class_name; } 00157 csString GetInterfaceName() const { return interface_name; } 00158 scfInterfaceID GetInterfaceID() const { return interface_id; } 00159 int GetInterfaceVersion() const { return interface_version; } 00160 }; 00161 00162 00168 class CS_CRYSTALSPACE_EXPORT csInitializer 00169 { 00170 public: 00199 static iObjectRegistry* CreateEnvironment(int argc, char const* const argv[]); 00200 00205 static bool InitializeSCF (int argc, char const* const argv[]); 00206 00212 static iObjectRegistry* CreateObjectRegistry (); 00213 00220 static iPluginManager* CreatePluginManager (iObjectRegistry*); 00221 00228 static iEventQueue* CreateEventQueue (iObjectRegistry*); 00229 00236 static iVirtualClock* CreateVirtualClock (iObjectRegistry*); 00237 00243 static iCommandLineParser* CreateCommandLineParser ( 00244 iObjectRegistry*, int argc, char const* const argv[]); 00245 00250 static iVerbosityManager* CreateVerbosityManager (iObjectRegistry*); 00251 00257 static iConfigManager* CreateConfigManager (iObjectRegistry*); 00258 00265 static bool CreateInputDrivers (iObjectRegistry*); 00266 00276 static bool CreateStringSet (iObjectRegistry*); 00277 00283 static iSystemOpenManager* CreateSystemOpenManager (iObjectRegistry*); 00284 00297 static bool SetupConfigManager (iObjectRegistry*, const char* configName, 00298 const char *ApplicationID = 0); 00299 00311 static iVFS* SetupVFS(iObjectRegistry* objectReg, 00312 const char* pluginID = "crystalspace.kernel.vfs"); 00313 00325 static bool RequestPlugins (iObjectRegistry*, ...); 00326 00332 static bool RequestPluginsV (iObjectRegistry*, va_list); 00333 00353 static bool RequestPlugins(iObjectRegistry*,csArray<csPluginRequest> const&); 00354 00359 static bool OpenApplication (iObjectRegistry*); 00360 00364 static void CloseApplication (iObjectRegistry*); 00365 00374 static bool SetupEventHandler (iObjectRegistry*, iEventHandler*, const csEventID[]); 00375 00382 static bool SetupEventHandler (iObjectRegistry*, csEventHandlerFunc, const csEventID events[]); 00383 00391 static bool SetupEventHandler (iObjectRegistry*, csEventHandlerFunc); 00392 00421 static void DestroyApplication (iObjectRegistry*); 00422 00428 static const char* GetDefaultAppID(); 00429 protected: 00430 }; 00431 00434 #endif // __CS_INITAPP_H__
Generated for Crystal Space 1.4.0 by doxygen 1.5.8