]> git.mxchange.org Git - flightgear.git/blob - src/Main/main.cxx
59737e5fac3a90199d98c502b4f1f9942a43f5cc
[flightgear.git] / src / Main / main.cxx
1 // main.cxx -- top level sim routines
2 //
3 // Written by Curtis Olson, started May 1997.
4 //
5 // Copyright (C) 1997 - 2002  Curtis L. Olson  - http://www.flightgear.org/~curt
6 //
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
11 //
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15 // General Public License for more details.
16 //
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software
19 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
20 //
21 // $Id$
22
23
24 #ifdef HAVE_CONFIG_H
25 #  include <config.h>
26 #endif
27
28 #include <simgear/compiler.h>
29
30 #if defined(__linux__) && defined(__i386__)
31 #  include <fpu_control.h>
32 #  include <signal.h>
33 #endif
34
35 #include <iostream>
36
37 #include <osg/Camera>
38 #include <osg/GraphicsContext>
39 #include <osgDB/Registry>
40
41 // Class references
42 #include <simgear/scene/model/modellib.hxx>
43 #include <simgear/scene/material/matlib.hxx>
44 #include <simgear/scene/model/animation.hxx>
45 #include <simgear/scene/sky/sky.hxx>
46 #include <simgear/structure/event_mgr.hxx>
47 #include <simgear/props/AtomicChangeListener.hxx>
48 #include <simgear/props/props.hxx>
49 #include <simgear/timing/sg_time.hxx>
50 #include <simgear/magvar/magvar.hxx>
51 #include <simgear/math/sg_random.h>
52 #include <simgear/io/raw_socket.hxx>
53 #include <simgear/misc/sg_sleep.hxx>
54
55 #include <Time/light.hxx>
56 #include <Aircraft/replay.hxx>
57 #include <Aircraft/controls.hxx>
58 #include <Model/panelnode.hxx>
59 #include <Model/acmodel.hxx>
60 #include <Scenery/scenery.hxx>
61 #include <Scenery/tilemgr.hxx>
62 #include <Sound/fg_fx.hxx>
63 #include <Sound/beacon.hxx>
64 #include <Sound/morse.hxx>
65 #include <Sound/fg_fx.hxx>
66 #include <ATCDCL/ATCmgr.hxx>
67 #include <Time/TimeManager.hxx>
68 #include <Environment/environment_mgr.hxx>
69 #include <Environment/ephemeris.hxx>
70 #include <GUI/gui.h>
71 #include <GUI/new_gui.hxx>
72 #include <MultiPlayer/multiplaymgr.hxx>
73
74 #include "CameraGroup.hxx"
75 #include "fg_commands.hxx"
76 #include "fg_io.hxx"
77 #include "renderer.hxx"
78 #include "splash.hxx"
79 #include "main.hxx"
80 #include "util.hxx"
81 #include "fg_init.hxx"
82 #include "fg_os.hxx"
83 #include "WindowSystemAdapter.hxx"
84 #include <Main/viewer.hxx>
85
86
87 using namespace flightgear;
88
89 using std::cerr;
90
91 // Specify our current idle function state.  This is used to run all
92 // our initializations out of the idle callback so that we can get a
93 // splash screen up and running right away.
94 int idle_state = 0;
95
96
97 void fgInitSoundManager();
98 void fgSetNewSoundDevice(const char *);
99
100 // The atexit() function handler should know when the graphical subsystem
101 // is initialized.
102 extern int _bootstrap_OSInit;
103
104 // What should we do when we have nothing else to do?  Let's get ready
105 // for the next move and update the display?
106 static void fgMainLoop( void ) {
107     
108     static SGConstPropertyNode_ptr longitude
109         = fgGetNode("/position/longitude-deg");
110     static SGConstPropertyNode_ptr latitude
111         = fgGetNode("/position/latitude-deg");
112     static SGConstPropertyNode_ptr altitude
113         = fgGetNode("/position/altitude-ft");
114     static SGConstPropertyNode_ptr vn_fps
115         = fgGetNode("/velocities/speed-north-fps");
116     static SGConstPropertyNode_ptr ve_fps
117         = fgGetNode("/velocities/speed-east-fps");
118     static SGConstPropertyNode_ptr vd_fps
119         = fgGetNode("/velocities/speed-down-fps");
120       
121     static SGPropertyNode_ptr frame_signal
122         = fgGetNode("/sim/signals/frame", true);
123
124     static SGPropertyNode_ptr _statisticsFlag
125         = fgGetNode("/sim/timing-statistics/enabled", true);
126     static SGPropertyNode_ptr _statisticsInterval
127         = fgGetNode("/sim/timing-statistics/interval-s", true);
128     static SGPropertyNode_ptr _statiticsMinJitter
129         = fgGetNode("/sim/timing-statistics/min-jitter-ms", true);
130     static SGPropertyNode_ptr _statiticsMinTime
131         = fgGetNode("/sim/timing-statistics/min-time-ms", true);
132
133     frame_signal->fireValueChanged();
134     SGCloudLayer::enable_bump_mapping = fgGetBool("/sim/rendering/bump-mapping");
135     
136     SG_LOG( SG_ALL, SG_DEBUG, "Running Main Loop");
137     SG_LOG( SG_ALL, SG_DEBUG, "======= ==== ====");
138     
139     
140   // update "time"
141     double sim_dt, real_dt;
142     TimeManager* timeMgr = (TimeManager*) globals->get_subsystem("time");
143     // compute simulated time (allowing for pause, warp, etc) and
144     // real elapsed time
145     timeMgr->computeTimeDeltas(sim_dt, real_dt);
146
147     // update magvar model
148     globals->get_mag()->update( longitude->getDoubleValue()
149                                 * SGD_DEGREES_TO_RADIANS,
150                                 latitude->getDoubleValue()
151                                 * SGD_DEGREES_TO_RADIANS,
152                                 altitude->getDoubleValue() * SG_FEET_TO_METER,
153                                 globals->get_time_params()->getJD() );
154
155     // Run ATC subsystem
156     globals->get_ATC_mgr()->update(sim_dt);
157     
158     globals->get_subsystem_mgr()->update(sim_dt);
159
160     // Update the sound manager last so it can use the CPU while the GPU
161     // is processing the scenery (doubled the frame-rate for me) -EMH-
162 #ifdef ENABLE_AUDIO_SUPPORT
163     static bool smgr_init = true;
164     static SGPropertyNode *sound_working = fgGetNode("/sim/sound/working");
165     if (smgr_init == true) {
166         if (sound_working->getBoolValue() == true) {
167             fgInitSoundManager();
168             smgr_init = false;
169         }
170     } else {
171         static SGPropertyNode *sound_enabled = fgGetNode("/sim/sound/enabled");
172         static SGSoundMgr *smgr = globals->get_soundmgr();
173         static bool smgr_enabled = true;
174
175         if (sound_working->getBoolValue() == false) {   // request to reinit
176            smgr->reinit();
177            smgr->resume();
178            sound_working->setBoolValue(true);
179         }
180
181         if (smgr_enabled != sound_enabled->getBoolValue()) {
182             if (smgr_enabled == true) { // request to suspend
183                 smgr->suspend();
184                 smgr_enabled = false;
185             } else {
186                 smgr->resume();
187                 smgr_enabled = true;
188             }
189         }
190
191         if (smgr_enabled == true) {
192             static SGPropertyNode *volume = fgGetNode("/sim/sound/volume");
193             smgr->set_volume(volume->getFloatValue());
194             smgr->update(sim_dt);
195         }
196     }
197 #endif
198
199     // END Tile Manager updates
200     bool scenery_loaded = fgGetBool("sim/sceneryloaded");
201     if (!scenery_loaded)
202     {
203         if (globals->get_tile_mgr()->isSceneryLoaded()
204              && fgGetBool("sim/fdm-initialized")) {
205             fgSetBool("sim/sceneryloaded",true);
206             fgSplashProgress("");
207             if (fgGetBool("/sim/sound/working")) {
208                 globals->get_soundmgr()->activate();
209             }
210             globals->get_props()->tie("/sim/sound/devices/name",
211                   SGRawValueFunctions<const char *>(0, fgSetNewSoundDevice), false);
212         }
213         else
214         {
215             fgSplashProgress("loading scenery");
216             // be nice to loader threads while waiting for initial scenery, reduce to 2fps
217             simgear::sleepForMSec(500);
218         }
219     }
220
221     // print timing statistics
222     static bool _lastStatisticsFlag = false;
223     if (_lastStatisticsFlag != _statisticsFlag->getBoolValue())
224     {
225         // flag has changed, update subsystem manager
226         _lastStatisticsFlag = _statisticsFlag->getBoolValue();
227         globals->get_subsystem_mgr()->collectDebugTiming(_lastStatisticsFlag);
228     }
229     if (_lastStatisticsFlag)
230     {
231         static double elapsed = 0;
232         elapsed += real_dt;
233         if (elapsed >= _statisticsInterval->getDoubleValue())
234         {
235             // print and reset timing statistics
236             globals->get_subsystem_mgr()->printTimingStatistics(_statiticsMinTime->getDoubleValue(),
237                                                                 _statiticsMinJitter->getDoubleValue());
238             elapsed = 0;
239         }
240     }
241
242     simgear::AtomicChangeListener::fireChangeListeners();
243
244     SG_LOG( SG_ALL, SG_DEBUG, "" );
245 }
246
247 void fgInitSoundManager()
248 {
249     SGSoundMgr *smgr = globals->get_soundmgr();
250
251     smgr->bind();
252     smgr->init(fgGetString("/sim/sound/device-name", NULL));
253
254     vector <const char*>devices = smgr->get_available_devices();
255     for (unsigned int i=0; i<devices.size(); i++) {
256         SGPropertyNode *p = fgGetNode("/sim/sound/devices/device", i, true);
257         p->setStringValue(devices[i]);
258     }
259     devices.clear();
260 }
261
262 void fgSetNewSoundDevice(const char *device)
263 {
264     globals->get_soundmgr()->suspend();
265     globals->get_soundmgr()->stop();
266     globals->get_soundmgr()->init(device);
267     globals->get_soundmgr()->resume();
268 }
269
270 // Operation for querying OpenGL parameters. This must be done in a
271 // valid OpenGL context, potentially in another thread.
272 namespace
273 {
274 struct GeneralInitOperation : public GraphicsContextOperation
275 {
276     GeneralInitOperation()
277         : GraphicsContextOperation(std::string("General init"))
278     {
279     }
280     void run(osg::GraphicsContext* gc)
281     {
282         SGPropertyNode* simRendering = fgGetNode("/sim/rendering");
283         
284         simRendering->setStringValue("gl-vendor", (char*) glGetString(GL_VENDOR));
285         SG_LOG( SG_GENERAL, SG_INFO, glGetString(GL_VENDOR));
286         
287         simRendering->setStringValue("gl-renderer", (char*) glGetString(GL_RENDERER));
288         SG_LOG( SG_GENERAL, SG_INFO, glGetString(GL_RENDERER));
289         
290         simRendering->setStringValue("gl-version", (char*) glGetString(GL_VERSION));
291         SG_LOG( SG_GENERAL, SG_INFO, glGetString(GL_VERSION));
292
293         GLint tmp;
294         glGetIntegerv( GL_MAX_TEXTURE_SIZE, &tmp );
295         simRendering->setIntValue("max-texture-size", tmp);
296
297         glGetIntegerv( GL_DEPTH_BITS, &tmp );
298         simRendering->setIntValue("depth-buffer-bits", tmp);
299     }
300 };
301
302
303 osg::Node* load_panel(SGPropertyNode *n)
304 {
305     osg::Geode* geode = new osg::Geode;
306     geode->addDrawable(new FGPanelNode(n));
307     return geode;
308 }
309
310 SGPath resolve_path(const std::string& s)
311 {
312   return globals->resolve_maybe_aircraft_path(s);
313 }
314
315 }
316
317 // This is the top level master main function that is registered as
318 // our idle function
319
320 // The first few passes take care of initialization things (a couple
321 // per pass) and once everything has been initialized fgMainLoop from
322 // then on.
323
324 static void fgIdleFunction ( void ) {
325     static osg::ref_ptr<GeneralInitOperation> genOp;
326     if ( idle_state == 0 ) {
327         idle_state++;
328         // Pick some window on which to do queries.
329         // XXX Perhaps all this graphics initialization code should be
330         // moved to renderer.cxx?
331         genOp = new GeneralInitOperation;
332         osg::Camera* guiCamera = getGUICamera(CameraGroup::getDefault());
333         WindowSystemAdapter* wsa = WindowSystemAdapter::getWSA();
334         osg::GraphicsContext* gc = 0;
335         if (guiCamera)
336             gc = guiCamera->getGraphicsContext();
337         if (gc) {
338             gc->add(genOp.get());
339         } else {
340             wsa->windows[0]->gc->add(genOp.get());
341         }
342         guiStartInit(gc);
343     } else if ( idle_state == 1 ) {
344         if (genOp.valid()) {
345             if (!genOp->isFinished())
346                 return;
347             genOp = 0;
348         }
349         if (!guiFinishInit())
350             return;
351         idle_state++;
352         fgSplashProgress("loading aircraft list");
353
354     } else if ( idle_state == 2 ) {
355         idle_state++;
356         fgSplashProgress("loading navigation data");
357
358     } else if ( idle_state == 3 ) {
359         idle_state++;
360         fgInitNav();
361
362         fgSplashProgress("initializing scenery system");
363
364     } else if ( idle_state == 4 ) {
365         idle_state++;
366         // based on the requested presets, calculate the true starting
367         // lon, lat
368         fgInitPosition();
369         fgInitTowerLocationListener();
370
371         TimeManager* t = new TimeManager;
372         globals->add_subsystem("time", t, SGSubsystemMgr::INIT);
373         t->init(); // need to init now, not during initSubsystems
374         
375         // Do some quick general initializations
376         if( !fgInitGeneral()) {
377             SG_LOG( SG_GENERAL, SG_ALERT,
378                 "General initialization failed ..." );
379             exit(-1);
380         }
381
382         ////////////////////////////////////////////////////////////////////
383         // Initialize the property-based built-in commands
384         ////////////////////////////////////////////////////////////////////
385         fgInitCommands();
386
387         ////////////////////////////////////////////////////////////////////
388         // Initialize the material manager
389         ////////////////////////////////////////////////////////////////////
390         globals->set_matlib( new SGMaterialLib );
391         simgear::SGModelLib::init(globals->get_fg_root(), globals->get_props());
392         simgear::SGModelLib::setPanelFunc(load_panel);
393
394         ////////////////////////////////////////////////////////////////////
395         // Initialize the TG scenery subsystem.
396         ////////////////////////////////////////////////////////////////////
397         globals->set_scenery( new FGScenery );
398         globals->get_scenery()->init();
399         globals->get_scenery()->bind();
400         globals->set_tile_mgr( new FGTileMgr );
401
402         fgSplashProgress("loading aircraft");
403
404     } else if ( idle_state == 5 ) {
405         idle_state++;
406
407         fgSplashProgress("initializing sky elements");
408
409     } else if ( idle_state == 6 ) {
410         idle_state++;
411         // Initialize the sky
412
413         Ephemeris* eph = new Ephemeris;
414         globals->add_subsystem("ephemeris", eph);
415         eph->init(); // FIXME - remove this once SGSky code below is also a subsystem
416         eph->bind();
417
418         // TODO: move to environment mgr
419         thesky = new SGSky;
420         SGPath texture_path(globals->get_fg_root());
421         texture_path.append("Textures");
422         texture_path.append("Sky");
423         for (int i = 0; i < FGEnvironmentMgr::MAX_CLOUD_LAYERS; i++) {
424             SGCloudLayer * layer = new SGCloudLayer(texture_path.str());
425             thesky->add_cloud_layer(layer);
426         }
427
428         SGPath sky_tex_path( globals->get_fg_root() );
429         sky_tex_path.append( "Textures" );
430         sky_tex_path.append( "Sky" );
431         thesky->texture_path( sky_tex_path.str() );
432
433         // The sun and moon diameters are scaled down numbers of the
434         // actual diameters. This was needed to fit both the sun and the
435         // moon within the distance to the far clip plane.
436         // Moon diameter:    3,476 kilometers
437         // Sun diameter: 1,390,000 kilometers
438         thesky->build( 80000.0, 80000.0,
439                        463.3, 361.8,
440                        *globals->get_ephem(),
441                        fgGetNode("/environment", true));
442
443         // Initialize MagVar model
444         SGMagVar *magvar = new SGMagVar();
445         globals->set_mag( magvar );
446
447
448                                     // kludge to initialize mag compass
449                                     // (should only be done for in-flight
450                                     // startup)
451         // update magvar model
452         globals->get_mag()->update( fgGetDouble("/position/longitude-deg")
453                                     * SGD_DEGREES_TO_RADIANS,
454                                     fgGetDouble("/position/latitude-deg")
455                                     * SGD_DEGREES_TO_RADIANS,
456                                     fgGetDouble("/position/altitude-ft")
457                                     * SG_FEET_TO_METER,
458                                     globals->get_time_params()->getJD() );
459         double var = globals->get_mag()->get_magvar() * SGD_RADIANS_TO_DEGREES;
460         fgSetDouble("/instrumentation/heading-indicator/offset-deg", -var);
461         fgSetDouble("/instrumentation/heading-indicator-fg/offset-deg", -var);
462
463
464         // airport = new ssgBranch;
465         // airport->setName( "Airport Lighting" );
466         // lighting->addKid( airport );
467
468         fgSplashProgress("initializing subsystems");
469
470     } else if ( idle_state == 7 ) {
471         idle_state++;
472         // Initialize audio support
473 #ifdef ENABLE_AUDIO_SUPPORT
474
475         // Start the intro music
476         if ( fgGetBool("/sim/startup/intro-music") ) {
477             SGPath mp3file( globals->get_fg_root() );
478             mp3file.append( "Sounds/intro.mp3" );
479
480             SG_LOG( SG_GENERAL, SG_INFO,
481                 "Starting intro music: " << mp3file.str() );
482
483 # if defined( __CYGWIN__ )
484             string command = "start /m `cygpath -w " + mp3file.str() + "`";
485 # elif defined( _WIN32 )
486             string command = "start /m " + mp3file.str();
487 # else
488             string command = "mpg123 " + mp3file.str() + "> /dev/null 2>&1";
489 # endif
490
491             system ( command.c_str() );
492         }
493 #endif
494         // This is the top level init routine which calls all the
495         // other subsystem initialization routines.  If you are adding
496         // a subsystem to flightgear, its initialization call should be
497         // located in this routine.
498         if( !fgInitSubsystems()) {
499             SG_LOG( SG_GENERAL, SG_ALERT,
500                 "Subsystem initialization failed ..." );
501             exit(-1);
502         }
503
504         // Torsten Dreyer:
505         // ugly hack for automatic runway selection on startup based on
506         // metar data. Makes startup.nas obsolete and guarantees the same
507         // runway selection as for AI traffic. However, this code belongs to
508         // somewhere(?) else - if I only new where...
509         if( true == fgGetBool( "/environment/metar/valid" ) ) {
510             // the realwx_ctrl fetches metar in the foreground on init,
511             // If it was able to fetch a metar or one was given on the commandline,
512             // the valid flag is set here, otherwise it is false
513             double hdg = fgGetDouble( "/environment/metar/base-wind-dir-deg", 9999.0 );
514             string apt = fgGetString( "/sim/startup/options/airport" );
515             string rwy = fgGetString( "/sim/startup/options/runway" );
516             double strthdg = fgGetDouble( "/sim/startup/options/heading-deg", 9999.0 );
517             string parkpos = fgGetString( "/sim/presets/parkpos" );
518             bool onground = fgGetBool( "/sim/presets/onground", false );
519             // don't check for wind-speed < 1kt, this belongs to the runway-selection code
520             // the other logic is taken from former startup.nas
521             if( hdg < 360.0 && apt.length() > 0 && strthdg > 360.0 && rwy.length() == 0 && onground && parkpos.length() == 0 ) {
522                 extern bool fgSetPosFromAirportIDandHdg( const string& id, double tgt_hdg );
523                 fgSetPosFromAirportIDandHdg( apt, hdg );
524             }
525         }
526
527         fgSplashProgress("initializing graphics engine");
528
529     } else if ( idle_state == 8 ) {
530         idle_state = 1000;
531         
532         // setup OpenGL view parameters
533         globals->get_renderer()->setupView();
534
535         globals->get_renderer()->resize( fgGetInt("/sim/startup/xsize"),
536                                          fgGetInt("/sim/startup/ysize") );
537
538         int session = fgGetInt("/sim/session",0);
539         session++;
540         fgSetInt("/sim/session",session);
541     }
542
543     if ( idle_state == 1000 ) {
544         // We've finished all our initialization steps, from now on we
545         // run the main loop.
546         fgSetBool("sim/sceneryloaded", false);
547         fgRegisterIdleHandler( fgMainLoop );
548     }
549 }
550
551 static void fgWinResizeFunction(int width, int height)
552 {
553     globals->get_renderer()->resize(width, height);
554 }
555
556 static void upper_case_property(const char *name)
557 {
558     using namespace simgear;
559     SGPropertyNode *p = fgGetNode(name, false);
560     if (!p) {
561         p = fgGetNode(name, true);
562         p->setStringValue("");
563     } else {
564         props::Type t = p->getType();
565         if (t == props::NONE || t == props::UNSPECIFIED)
566             p->setStringValue("");
567         else
568             assert(t == props::STRING);
569     }
570     p->addChangeListener(new FGMakeUpperCase);
571 }
572
573
574 // Main top level initialization
575 int fgMainInit( int argc, char **argv ) {
576
577     // set default log levels
578     sglog().setLogLevels( SG_ALL, SG_ALERT );
579
580     string version;
581 #ifdef FLIGHTGEAR_VERSION
582     version = FLIGHTGEAR_VERSION;
583 #else
584     version = "unknown version";
585 #endif
586     SG_LOG( SG_GENERAL, SG_INFO, "FlightGear:  Version "
587             << version );
588     SG_LOG( SG_GENERAL, SG_INFO, "Built with " << SG_COMPILER_STR << endl );
589
590     // Allocate global data structures.  This needs to happen before
591     // we parse command line options
592
593     globals = new FGGlobals;
594
595     // seed the random number generator
596     sg_srandom_time();
597
598     FGControls *controls = new FGControls;
599     globals->set_controls( controls );
600
601     string_list *col = new string_list;
602     globals->set_channel_options_list( col );
603
604     fgValidatePath("", false);  // initialize static variables
605     upper_case_property("/sim/presets/airport-id");
606     upper_case_property("/sim/presets/runway");
607     upper_case_property("/sim/tower/airport-id");
608     upper_case_property("/autopilot/route-manager/input");
609
610     // Scan the config file(s) and command line options to see if
611     // fg_root was specified (ignore all other options for now)
612     fgInitFGRoot(argc, argv);
613
614     // Check for the correct base package version
615     static char required_version[] = "2.0.0";
616     string base_version = fgBasePackageVersion();
617     if ( !(base_version == required_version) ) {
618         // tell the operator how to use this application
619
620         SG_LOG( SG_GENERAL, SG_ALERT, "" ); // To popup the console on windows
621         cerr << endl << "Base package check failed ... " \
622              << "Found version " << base_version << " at: " \
623              << globals->get_fg_root() << endl;
624         cerr << "Please upgrade to version: " << required_version << endl;
625 #ifdef _MSC_VER
626         cerr << "Hit a key to continue..." << endl;
627         cin.get();
628 #endif
629         exit(-1);
630     }
631
632     // Load the configuration parameters.  (Command line options
633     // override config file options.  Config file options override
634     // defaults.)
635     if ( !fgInitConfig(argc, argv) ) {
636         SG_LOG( SG_GENERAL, SG_ALERT, "Config option parsing failed ..." );
637         exit(-1);
638     }
639
640     // Initialize the Window/Graphics environment.
641     fgOSInit(&argc, argv);
642     _bootstrap_OSInit++;
643
644     fgRegisterWindowResizeHandler( &fgWinResizeFunction );
645     fgRegisterIdleHandler( &fgIdleFunction );
646     fgRegisterDrawHandler( &FGRenderer::update );
647
648     // Initialize sockets (WinSock needs this)
649     simgear::Socket::initSockets();
650
651     // Clouds3D requires an alpha channel
652     fgOSOpenWindow(true /* request stencil buffer */);
653
654     // Initialize the splash screen right away
655     fntInit();
656     fgSplashInit();
657
658     // pass control off to the master event handler
659     int result = fgOSMainLoop();
660     
661     // clean up here; ensure we null globals to avoid
662     // confusing the atexit() handler
663     delete globals;
664     globals = NULL;
665     
666     return result;
667 }