src/Main/viewmgr.cxx

   1 // viewmgr.cxx -- class for managing all the views in the flightgear world.
   2 //
   3 // Written by Curtis Olson, started October 2000.
   4 //   partially rewritten by Jim Wilson March 2002
   5 //
   6 // Copyright (C) 2000  Curtis L. Olson  - http://www.flightgear.org/~curt
   7 //
   8 // This program is free software; you can redistribute it and/or
   9 // modify it under the terms of the GNU General Public License as
  10 // published by the Free Software Foundation; either version 2 of the
  11 // License, or (at your option) any later version.
  12 //
  13 // This program is distributed in the hope that it will be useful, but
  14 // WITHOUT ANY WARRANTY; without even the implied warranty of
  15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 // General Public License for more details.
  17 //
  18 // You should have received a copy of the GNU General Public License
  19 // along with this program; if not, write to the Free Software
  20 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  21 //
  22 // $Id$
  23
  24 #ifdef HAVE_CONFIG_H
  25 #  include "config.h"
  26 #endif
  27
  28 #include "viewmgr.hxx"
  29
  30 #include <string.h>             // strcmp
  31
  32 #include <simgear/compiler.h>
  33 #include <simgear/sound/soundmgr_openal.hxx>
  34 #include <Model/acmodel.hxx>
  35 #include <Main/viewer.hxx>
  36 #include <Main/fg_props.hxx>
  37
  38 // Constructor
  39 FGViewMgr::FGViewMgr( void ) :
  40   axis_long(0),
  41   axis_lat(0),
  42   view_number(fgGetNode("/sim/current-view/view-number", true)),
  43   config_list(fgGetNode("/sim", true)->getChildren("view")),
  44   current(0)
  45 {
  46     smgr = globals->get_soundmgr();
  47 }
  48
  49 // Destructor
  50 FGViewMgr::~FGViewMgr( void ) {
  51 }
  52
  53 void
  54 FGViewMgr::init ()
  55 {
  56   double aspect_ratio_multiplier
  57       = fgGetDouble("/sim/current-view/aspect-ratio-multiplier");
  58
  59   for (unsigned int i = 0; i < config_list.size(); i++) {
  60     SGPropertyNode *n = config_list[i];
  61
  62     // find out if this is an internal view (e.g. in cockpit, low near plane)
  63     bool internal = n->getBoolValue("internal", false);
  64
  65     // FIXME:
  66     // this is assumed to be an aircraft model...we will need to read
  67     // model-from-type as well.
  68
  69     // find out if this is a model we are looking from...
  70     bool from_model = n->getBoolValue("config/from-model");
  71     int from_model_index = n->getIntValue("config/from-model-idx");
  72
  73     double x_offset_m = n->getDoubleValue("config/x-offset-m");
  74     double y_offset_m = n->getDoubleValue("config/y-offset-m");
  75     double z_offset_m = n->getDoubleValue("config/z-offset-m");
  76
  77     double heading_offset_deg = n->getDoubleValue("config/heading-offset-deg");
  78     n->setDoubleValue("config/heading-offset-deg", heading_offset_deg);
  79     double pitch_offset_deg = n->getDoubleValue("config/pitch-offset-deg");
  80     n->setDoubleValue("config/pitch-offset-deg", pitch_offset_deg);
  81     double roll_offset_deg = n->getDoubleValue("config/roll-offset-deg");
  82     n->setDoubleValue("config/roll-offset-deg", roll_offset_deg);
  83
  84     double fov_deg = n->getDoubleValue("config/default-field-of-view-deg");
  85     double near_m = n->getDoubleValue("config/ground-level-nearplane-m");
  86
  87     // supporting two types "lookat" = 1 and "lookfrom" = 0
  88     const char *type = n->getStringValue("type");
  89     if (!strcmp(type, "lookat")) {
  90
  91       bool at_model = n->getBoolValue("config/at-model");
  92       int at_model_index = n->getIntValue("config/at-model-idx");
  93
  94       double damp_roll = n->getDoubleValue("config/at-model-roll-damping");
  95       double damp_pitch = n->getDoubleValue("config/at-model-pitch-damping");
  96       double damp_heading = n->getDoubleValue("config/at-model-heading-damping");
  97
  98       double target_x_offset_m = n->getDoubleValue("config/target-x-offset-m");
  99       double target_y_offset_m = n->getDoubleValue("config/target-y-offset-m");
 100       double target_z_offset_m = n->getDoubleValue("config/target-z-offset-m");
 101
 102       add_view(new FGViewer ( FG_LOOKAT, from_model, from_model_index,
 103                               at_model, at_model_index,
 104                               damp_roll, damp_pitch, damp_heading,
 105                               x_offset_m, y_offset_m,z_offset_m,
 106                               heading_offset_deg, pitch_offset_deg,
 107                               roll_offset_deg, fov_deg, aspect_ratio_multiplier,
 108                               target_x_offset_m, target_y_offset_m,
 109                               target_z_offset_m, near_m, internal ));
 110     } else {
 111       add_view(new FGViewer ( FG_LOOKFROM, from_model, from_model_index,
 112                               false, 0, 0.0, 0.0, 0.0,
 113                               x_offset_m, y_offset_m, z_offset_m,
 114                               heading_offset_deg, pitch_offset_deg,
 115                               roll_offset_deg, fov_deg, aspect_ratio_multiplier,
 116                               0, 0, 0, near_m, internal ));
 117     }
 118   }
 119
 120   copyToCurrent();
 121 }
 122
 123 void
 124 FGViewMgr::reinit ()
 125 {
 126   // reset offsets and fov to configuration defaults
 127   for (unsigned int i = 0; i < config_list.size(); i++) {
 128     SGPropertyNode *n = config_list[i];
 129     setView(i);
 130
 131     fgSetDouble("/sim/current-view/x-offset-m",
 132         n->getDoubleValue("config/x-offset-m"));
 133     fgSetDouble("/sim/current-view/y-offset-m",
 134         n->getDoubleValue("config/y-offset-m"));
 135     fgSetDouble("/sim/current-view/z-offset-m",
 136         n->getDoubleValue("config/z-offset-m"));
 137     fgSetDouble("/sim/current-view/pitch-offset-deg",
 138         n->getDoubleValue("config/pitch-offset-deg"));
 139     fgSetDouble("/sim/current-view/heading-offset-deg",
 140         n->getDoubleValue("config/heading-offset-deg"));
 141     fgSetDouble("/sim/current-view/roll-offset-deg",
 142         n->getDoubleValue("config/roll-offset-deg"));
 143
 144     double fov_deg = n->getDoubleValue("config/default-field-of-view-deg");
 145     if (fov_deg < 10.0)
 146       fov_deg = 55.0;
 147     fgSetDouble("/sim/current-view/field-of-view", fov_deg);
 148
 149     // target offsets for lookat mode only...
 150     fgSetDouble("/sim/current-view/target-x-offset-m",
 151         n->getDoubleValue("config/target-x-offset-m"));
 152     fgSetDouble("/sim/current-view/target-y-offset-m",
 153         n->getDoubleValue("config/target-y-offset-m"));
 154     fgSetDouble("/sim/current-view/target-z-offset-m",
 155         n->getDoubleValue("config/target-z-offset-m"));
 156   }
 157   setView(0);
 158 }
 159
 160 typedef double (FGViewMgr::*double_getter)() const;
 161
 162 void
 163 FGViewMgr::bind ()
 164 {
 165   // these are bound to the current view properties
 166   fgTie("/sim/current-view/heading-offset-deg", this,
 167         &FGViewMgr::getViewHeadingOffset_deg,
 168         &FGViewMgr::setViewHeadingOffset_deg);
 169   fgSetArchivable("/sim/current-view/heading-offset-deg");
 170   fgTie("/sim/current-view/goal-heading-offset-deg", this,
 171         &FGViewMgr::getViewGoalHeadingOffset_deg,
 172         &FGViewMgr::setViewGoalHeadingOffset_deg);
 173   fgSetArchivable("/sim/current-view/goal-heading-offset-deg");
 174   fgTie("/sim/current-view/pitch-offset-deg", this,
 175         &FGViewMgr::getViewPitchOffset_deg,
 176         &FGViewMgr::setViewPitchOffset_deg);
 177   fgSetArchivable("/sim/current-view/pitch-offset-deg");
 178   fgTie("/sim/current-view/goal-pitch-offset-deg", this,
 179         &FGViewMgr::getGoalViewPitchOffset_deg,
 180         &FGViewMgr::setGoalViewPitchOffset_deg);
 181   fgSetArchivable("/sim/current-view/goal-pitch-offset-deg");
 182   fgTie("/sim/current-view/roll-offset-deg", this,
 183         &FGViewMgr::getViewRollOffset_deg,
 184         &FGViewMgr::setViewRollOffset_deg);
 185   fgSetArchivable("/sim/current-view/roll-offset-deg");
 186   fgTie("/sim/current-view/goal-roll-offset-deg", this,
 187         &FGViewMgr::getGoalViewRollOffset_deg,
 188         &FGViewMgr::setGoalViewRollOffset_deg);
 189   fgSetArchivable("/sim/current-view/goal-roll-offset-deg");
 190
 191   fgTie("/sim/current-view/view-number", this,
 192                       &FGViewMgr::getView, &FGViewMgr::setView);
 193   fgSetArchivable("/sim/current-view/view-number", false);
 194
 195   fgTie("/sim/current-view/axes/long", this,
 196         (double_getter)0, &FGViewMgr::setViewAxisLong);
 197   fgSetArchivable("/sim/current-view/axes/long");
 198
 199   fgTie("/sim/current-view/axes/lat", this,
 200         (double_getter)0, &FGViewMgr::setViewAxisLat);
 201   fgSetArchivable("/sim/current-view/axes/lat");
 202
 203   fgTie("/sim/current-view/field-of-view", this,
 204         &FGViewMgr::getFOV_deg, &FGViewMgr::setFOV_deg);
 205   fgSetArchivable("/sim/current-view/field-of-view");
 206
 207   fgTie("/sim/current-view/aspect-ratio-multiplier", this,
 208         &FGViewMgr::getARM_deg, &FGViewMgr::setARM_deg);
 209   fgSetArchivable("/sim/current-view/field-of-view");
 210
 211   fgTie("/sim/current-view/ground-level-nearplane-m", this,
 212         &FGViewMgr::getNear_m, &FGViewMgr::setNear_m);
 213   fgSetArchivable("/sim/current-view/ground-level-nearplane-m");
 214
 215   SGPropertyNode *n = fgGetNode("/sim/current-view", true);
 216   n->tie("viewer-x-m", SGRawValuePointer<double>(&abs_viewer_position[0]));
 217   n->tie("viewer-y-m", SGRawValuePointer<double>(&abs_viewer_position[1]));
 218   n->tie("viewer-z-m", SGRawValuePointer<double>(&abs_viewer_position[2]));
 219
 220 // for automatic untying:
 221 #define x(str) ((void)tied_props.push_back(str), str)
 222
 223   fgTie(x("/sim/current-view/debug/orientation-w"), this,
 224         &FGViewMgr::getCurrentViewOrientation_w);
 225   fgTie(x("/sim/current-view/debug/orientation-x"), this,
 226         &FGViewMgr::getCurrentViewOrientation_x);
 227   fgTie(x("/sim/current-view/debug/orientation-y"), this,
 228         &FGViewMgr::getCurrentViewOrientation_y);
 229   fgTie(x("/sim/current-view/debug/orientation-z"), this,
 230         &FGViewMgr::getCurrentViewOrientation_z);
 231
 232   fgTie(x("/sim/current-view/debug/orientation_offset-w"), this,
 233         &FGViewMgr::getCurrentViewOrOffset_w);
 234   fgTie(x("/sim/current-view/debug/orientation_offset-x"), this,
 235         &FGViewMgr::getCurrentViewOrOffset_x);
 236   fgTie(x("/sim/current-view/debug/orientation_offset-y"), this,
 237         &FGViewMgr::getCurrentViewOrOffset_y);
 238   fgTie(x("/sim/current-view/debug/orientation_offset-z"), this,
 239         &FGViewMgr::getCurrentViewOrOffset_z);
 240
 241   fgTie(x("/sim/current-view/debug/frame-w"), this,
 242         &FGViewMgr::getCurrentViewFrame_w);
 243   fgTie(x("/sim/current-view/debug/frame-x"), this,
 244         &FGViewMgr::getCurrentViewFrame_x);
 245   fgTie(x("/sim/current-view/debug/frame-y"), this,
 246         &FGViewMgr::getCurrentViewFrame_y);
 247   fgTie(x("/sim/current-view/debug/frame-z"), this,
 248         &FGViewMgr::getCurrentViewFrame_z);
 249
 250 #undef x
 251 }
 252
 253 void
 254 FGViewMgr::unbind ()
 255 {
 256   // FIXME:
 257   // need to redo these bindings to the new locations (move to viewer?)
 258   fgUntie("/sim/current-view/heading-offset-deg");
 259   fgUntie("/sim/current-view/goal-heading-offset-deg");
 260   fgUntie("/sim/current-view/pitch-offset-deg");
 261   fgUntie("/sim/current-view/goal-pitch-offset-deg");
 262   fgUntie("/sim/current-view/field-of-view");
 263   fgUntie("/sim/current-view/aspect-ratio-multiplier");
 264   fgUntie("/sim/current-view/view-number");
 265   fgUntie("/sim/current-view/axes/long");
 266   fgUntie("/sim/current-view/axes/lat");
 267   fgUntie("/sim/current-view/ground-level-nearplane-m");
 268   fgUntie("/sim/current-view/viewer-x-m");
 269   fgUntie("/sim/current-view/viewer-y-m");
 270   fgUntie("/sim/current-view/viewer-z-m");
 271
 272   list<const char*>::const_iterator it;
 273   for (it = tied_props.begin(); it != tied_props.end(); it++){
 274     fgUntie(*it);
 275   }
 276
 277 }
 278
 279 void
 280 FGViewMgr::update (double dt)
 281 {
 282
 283   FGViewer *loop_view = (FGViewer *)get_current_view();
 284   if (loop_view == 0) return;
 285
 286   SGPropertyNode *n = config_list[current];
 287   double lon_deg, lat_deg, alt_ft, roll_deg, pitch_deg, heading_deg;
 288
 289   // Set up view location and orientation
 290
 291   if (!n->getBoolValue("config/from-model")) {
 292     lon_deg = fgGetDouble(n->getStringValue("config/eye-lon-deg-path"));
 293     lat_deg = fgGetDouble(n->getStringValue("config/eye-lat-deg-path"));
 294     alt_ft = fgGetDouble(n->getStringValue("config/eye-alt-ft-path"));
 295     roll_deg = fgGetDouble(n->getStringValue("config/eye-roll-deg-path"));
 296     pitch_deg = fgGetDouble(n->getStringValue("config/eye-pitch-deg-path"));
 297     heading_deg = fgGetDouble(n->getStringValue("config/eye-heading-deg-path"));
 298
 299     loop_view->setPosition(lon_deg, lat_deg, alt_ft);
 300     loop_view->setOrientation(roll_deg, pitch_deg, heading_deg);
 301   } else {
 302     // force recalc in viewer
 303     loop_view->set_dirty();
 304   }
 305
 306   // if lookat (type 1) then get target data...
 307   if (loop_view->getType() == FG_LOOKAT) {
 308     if (!n->getBoolValue("config/from-model")) {
 309       lon_deg = fgGetDouble(n->getStringValue("config/target-lon-deg-path"));
 310       lat_deg = fgGetDouble(n->getStringValue("config/target-lat-deg-path"));
 311       alt_ft = fgGetDouble(n->getStringValue("config/target-alt-ft-path"));
 312       roll_deg = fgGetDouble(n->getStringValue("config/target-roll-deg-path"));
 313       pitch_deg = fgGetDouble(n->getStringValue("config/target-pitch-deg-path"));
 314       heading_deg = fgGetDouble(n->getStringValue("config/target-heading-deg-path"));
 315
 316       loop_view->setTargetPosition(lon_deg, lat_deg, alt_ft);
 317       loop_view->setTargetOrientation(roll_deg, pitch_deg, heading_deg);
 318     } else {
 319       loop_view->set_dirty();
 320     }
 321   }
 322
 323   setViewXOffset_m(fgGetDouble("/sim/current-view/x-offset-m"));
 324   setViewYOffset_m(fgGetDouble("/sim/current-view/y-offset-m"));
 325   setViewZOffset_m(fgGetDouble("/sim/current-view/z-offset-m"));
 326
 327   setViewTargetXOffset_m(fgGetDouble("/sim/current-view/target-x-offset-m"));
 328   setViewTargetYOffset_m(fgGetDouble("/sim/current-view/target-y-offset-m"));
 329   setViewTargetZOffset_m(fgGetDouble("/sim/current-view/target-z-offset-m"));
 330
 331   current_view_orientation = loop_view->getViewOrientation();
 332   current_view_or_offset = loop_view->getViewOrientationOffset();
 333
 334   // Update the current view
 335   do_axes();
 336   loop_view->update(dt);
 337   abs_viewer_position = loop_view->getViewPosition();
 338
 339   // update audio listener values
 340   // set the viewer posotion in Cartesian coordinates in meters
 341   smgr->set_position( abs_viewer_position, loop_view->getPosition() );
 342   smgr->set_orientation( current_view_orientation );
 343
 344   // get the model velocity
 345   SGVec3d velocity = SGVec3d::zeros();
 346   if ( !stationary() ) {
 347     velocity = globals->get_aircraft_model()->getVelocity();
 348   }
 349   smgr->set_velocity( velocity );
 350 }
 351
 352 void
 353 FGViewMgr::copyToCurrent()
 354 {
 355     SGPropertyNode *n = config_list[current];
 356     fgSetString("/sim/current-view/name", n->getStringValue("name"));
 357     fgSetString("/sim/current-view/type", n->getStringValue("type"));
 358
 359     // copy certain view config data for default values
 360     fgSetDouble("/sim/current-view/config/heading-offset-deg",
 361                 n->getDoubleValue("config/default-heading-offset-deg"));
 362     fgSetDouble("/sim/current-view/config/pitch-offset-deg",
 363                 n->getDoubleValue("config/pitch-offset-deg"));
 364     fgSetDouble("/sim/current-view/config/roll-offset-deg",
 365                 n->getDoubleValue("config/roll-offset-deg"));
 366     fgSetDouble("/sim/current-view/config/default-field-of-view-deg",
 367                 n->getDoubleValue("config/default-field-of-view-deg"));
 368     fgSetBool("/sim/current-view/config/from-model",
 369                 n->getBoolValue("config/from-model"));
 370
 371     // copy view data
 372     fgSetDouble("/sim/current-view/x-offset-m", getViewXOffset_m());
 373     fgSetDouble("/sim/current-view/y-offset-m", getViewYOffset_m());
 374     fgSetDouble("/sim/current-view/z-offset-m", getViewZOffset_m());
 375
 376     fgSetDouble("/sim/current-view/goal-heading-offset-deg",
 377                 get_current_view()->getGoalHeadingOffset_deg());
 378     fgSetDouble("/sim/current-view/goal-pitch-offset-deg",
 379                 get_current_view()->getGoalPitchOffset_deg());
 380     fgSetDouble("/sim/current-view/goal-roll-offset-deg",
 381                 get_current_view()->getRollOffset_deg());
 382     fgSetDouble("/sim/current-view/heading-offset-deg",
 383                 get_current_view()->getHeadingOffset_deg());
 384     fgSetDouble("/sim/current-view/pitch-offset-deg",
 385                 get_current_view()->getPitchOffset_deg());
 386     fgSetDouble("/sim/current-view/roll-offset-deg",
 387                 get_current_view()->getRollOffset_deg());
 388     fgSetDouble("/sim/current-view/target-x-offset-m",
 389                 get_current_view()->getTargetXOffset_m());
 390     fgSetDouble("/sim/current-view/target-y-offset-m",
 391                 get_current_view()->getTargetYOffset_m());
 392     fgSetDouble("/sim/current-view/target-z-offset-m",
 393                 get_current_view()->getTargetZOffset_m());
 394     fgSetBool("/sim/current-view/internal",
 395                 get_current_view()->getInternal());
 396 }
 397
 398 void FGViewMgr::clear()
 399 {
 400   views.clear();
 401 }
 402
 403 FGViewer*
 404 FGViewMgr::get_current_view()
 405 {
 406         if ( current < (int)views.size() ) {
 407             return views[current];
 408         } else {
 409             return NULL;
 410         }
 411 }
 412
 413 const FGViewer*
 414 FGViewMgr::get_current_view() const
 415 {
 416         if ( current < (int)views.size() ) {
 417             return views[current];
 418         } else {
 419             return NULL;
 420         }
 421 }
 422
 423
 424 FGViewer*
 425 FGViewMgr::get_view( int i )
 426 {
 427         if ( i < 0 ) { i = 0; }
 428         if ( i >= (int)views.size() ) { i = views.size() - 1; }
 429         return views[i];
 430 }
 431
 432 const FGViewer*
 433 FGViewMgr::get_view( int i ) const
 434 {
 435         if ( i < 0 ) { i = 0; }
 436         if ( i >= (int)views.size() ) { i = views.size() - 1; }
 437         return views[i];
 438 }
 439
 440 FGViewer*
 441 FGViewMgr::next_view()
 442 {
 443         setView((current+1 < (int)views.size()) ? (current + 1) : 0);
 444         view_number->fireValueChanged();
 445         return views[current];
 446 }
 447
 448 FGViewer*
 449 FGViewMgr::prev_view()
 450 {
 451         setView((0 < current) ? (current - 1) : (views.size() - 1));
 452         view_number->fireValueChanged();
 453         return views[current];
 454 }
 455
 456 void
 457 FGViewMgr::add_view( FGViewer * v )
 458 {
 459   views.push_back(v);
 460   v->init();
 461 }
 462
 463 double
 464 FGViewMgr::getViewHeadingOffset_deg () const
 465 {
 466   const FGViewer * view = get_current_view();
 467   return (view == 0 ? 0 : view->getHeadingOffset_deg());
 468 }
 469
 470 void
 471 FGViewMgr::setViewHeadingOffset_deg (double offset)
 472 {
 473   FGViewer * view = get_current_view();
 474   if (view != 0) {
 475     view->setGoalHeadingOffset_deg(offset);
 476     view->setHeadingOffset_deg(offset);
 477   }
 478 }
 479
 480 double
 481 FGViewMgr::getViewGoalHeadingOffset_deg () const
 482 {
 483   const FGViewer * view = get_current_view();
 484   return (view == 0 ? 0 : view->getGoalHeadingOffset_deg());
 485 }
 486
 487 void
 488 FGViewMgr::setViewGoalHeadingOffset_deg (double offset)
 489 {
 490   FGViewer * view = get_current_view();
 491   if (view != 0)
 492     view->setGoalHeadingOffset_deg(offset);
 493 }
 494
 495 double
 496 FGViewMgr::getViewPitchOffset_deg () const
 497 {
 498   const FGViewer * view = get_current_view();
 499   return (view == 0 ? 0 : view->getPitchOffset_deg());
 500 }
 501
 502 void
 503 FGViewMgr::setViewPitchOffset_deg (double tilt)
 504 {
 505   FGViewer * view = get_current_view();
 506   if (view != 0) {
 507     view->setGoalPitchOffset_deg(tilt);
 508     view->setPitchOffset_deg(tilt);
 509   }
 510 }
 511
 512 double
 513 FGViewMgr::getGoalViewPitchOffset_deg () const
 514 {
 515   const FGViewer * view = get_current_view();
 516   return (view == 0 ? 0 : view->getGoalPitchOffset_deg());
 517 }
 518
 519 void
 520 FGViewMgr::setGoalViewPitchOffset_deg (double tilt)
 521 {
 522   FGViewer * view = get_current_view();
 523   if (view != 0)
 524     view->setGoalPitchOffset_deg(tilt);
 525 }
 526
 527 double
 528 FGViewMgr::getViewRollOffset_deg () const
 529 {
 530   const FGViewer * view = get_current_view();
 531   return (view == 0 ? 0 : view->getRollOffset_deg());
 532 }
 533
 534 void
 535 FGViewMgr::setViewRollOffset_deg (double tilt)
 536 {
 537   FGViewer * view = get_current_view();
 538   if (view != 0) {
 539     view->setGoalRollOffset_deg(tilt);
 540     view->setRollOffset_deg(tilt);
 541   }
 542 }
 543
 544 double
 545 FGViewMgr::getGoalViewRollOffset_deg () const
 546 {
 547   const FGViewer * view = get_current_view();
 548   return (view == 0 ? 0 : view->getGoalRollOffset_deg());
 549 }
 550
 551 void
 552 FGViewMgr::setGoalViewRollOffset_deg (double tilt)
 553 {
 554   FGViewer * view = get_current_view();
 555   if (view != 0)
 556     view->setGoalRollOffset_deg(tilt);
 557 }
 558
 559 double
 560 FGViewMgr::getViewXOffset_m () const
 561 {
 562   const FGViewer * view = get_current_view();
 563   if (view != 0) {
 564     return ((FGViewer *)view)->getXOffset_m();
 565   } else {
 566     return 0;
 567   }
 568 }
 569
 570 void
 571 FGViewMgr::setViewXOffset_m (double x)
 572 {
 573   FGViewer * view = get_current_view();
 574   if (view != 0) {
 575     view->setXOffset_m(x);
 576   }
 577 }
 578
 579 double
 580 FGViewMgr::getViewYOffset_m () const
 581 {
 582   const FGViewer * view = get_current_view();
 583   if (view != 0) {
 584     return ((FGViewer *)view)->getYOffset_m();
 585   } else {
 586     return 0;
 587   }
 588 }
 589
 590 void
 591 FGViewMgr::setViewYOffset_m (double y)
 592 {
 593   FGViewer * view = get_current_view();
 594   if (view != 0) {
 595     view->setYOffset_m(y);
 596   }
 597 }
 598
 599 double
 600 FGViewMgr::getViewZOffset_m () const
 601 {
 602   const FGViewer * view = get_current_view();
 603   if (view != 0) {
 604     return ((FGViewer *)view)->getZOffset_m();
 605   } else {
 606     return 0;
 607   }
 608 }
 609
 610 void
 611 FGViewMgr::setViewZOffset_m (double z)
 612 {
 613   FGViewer * view = get_current_view();
 614   if (view != 0) {
 615     view->setZOffset_m(z);
 616   }
 617 }
 618
 619 bool
 620 FGViewMgr::stationary () const
 621 {
 622   const FGViewer * view = get_current_view();
 623   if (view != 0) {
 624     if (((FGViewer *)view)->getXOffset_m() == 0.0 &&
 625         ((FGViewer *)view)->getYOffset_m() == 0.0 &&
 626         ((FGViewer *)view)->getZOffset_m() == 0.0)
 627       return true;
 628   }
 629
 630   return false;
 631 }
 632
 633 double
 634 FGViewMgr::getViewTargetXOffset_m () const
 635 {
 636   const FGViewer * view = get_current_view();
 637   if (view != 0) {
 638     return ((FGViewer *)view)->getTargetXOffset_m();
 639   } else {
 640     return 0;
 641   }
 642 }
 643
 644 void
 645 FGViewMgr::setViewTargetXOffset_m (double x)
 646 {
 647   FGViewer * view = get_current_view();
 648   if (view != 0) {
 649     view->setTargetXOffset_m(x);
 650   }
 651 }
 652
 653 double
 654 FGViewMgr::getViewTargetYOffset_m () const
 655 {
 656   const FGViewer * view = get_current_view();
 657   if (view != 0) {
 658     return ((FGViewer *)view)->getTargetYOffset_m();
 659   } else {
 660     return 0;
 661   }
 662 }
 663
 664 void
 665 FGViewMgr::setViewTargetYOffset_m (double y)
 666 {
 667   FGViewer * view = get_current_view();
 668   if (view != 0) {
 669     view->setTargetYOffset_m(y);
 670   }
 671 }
 672
 673 double
 674 FGViewMgr::getViewTargetZOffset_m () const
 675 {
 676   const FGViewer * view = get_current_view();
 677   if (view != 0) {
 678     return ((FGViewer *)view)->getTargetZOffset_m();
 679   } else {
 680     return 0;
 681   }
 682 }
 683
 684 void
 685 FGViewMgr::setViewTargetZOffset_m (double z)
 686 {
 687   FGViewer * view = get_current_view();
 688   if (view != 0) {
 689     view->setTargetZOffset_m(z);
 690   }
 691 }
 692
 693 int
 694 FGViewMgr::getView () const
 695 {
 696   return ( current );
 697 }
 698
 699 void
 700 FGViewMgr::setView (int newview)
 701 {
 702   // negative numbers -> set view with node index -newview
 703   if (newview < 0) {
 704     for (int i = 0; i < (int)config_list.size(); i++) {
 705       int index = -config_list[i]->getIndex();
 706       if (index == newview)
 707         newview = i;
 708     }
 709     if (newview < 0)
 710       return;
 711   }
 712
 713   // if newview number too low wrap to last view...
 714   if (newview < 0)
 715     newview = (int)views.size() - 1;
 716
 717   // if newview number to high wrap to zero...
 718   if (newview >= (int)views.size())
 719     newview = 0;
 720
 721   // set new view
 722   set_view(newview);
 723   // copy in view data
 724   copyToCurrent();
 725
 726   // Copy the fdm's position into the SGLocation which is shared with
 727   // some views ...
 728   globals->get_aircraft_model()->update(0);
 729   // Do the update ...
 730   update(0);
 731 }
 732
 733
 734 double
 735 FGViewMgr::getFOV_deg () const
 736 {
 737   const FGViewer * view = get_current_view();
 738   return (view == 0 ? 0 : view->get_fov());
 739 }
 740
 741 void
 742 FGViewMgr::setFOV_deg (double fov)
 743 {
 744   FGViewer * view = get_current_view();
 745   if (view != 0)
 746     view->set_fov(fov);
 747 }
 748
 749 double
 750 FGViewMgr::getARM_deg () const
 751 {
 752   const FGViewer * view = get_current_view();
 753   return (view == 0 ? 0 : view->get_aspect_ratio_multiplier());
 754 }
 755
 756 void
 757 FGViewMgr::setARM_deg (double aspect_ratio_multiplier)
 758 {
 759   FGViewer * view = get_current_view();
 760   if (view != 0)
 761     view->set_aspect_ratio_multiplier(aspect_ratio_multiplier);
 762 }
 763
 764 double
 765 FGViewMgr::getNear_m () const
 766 {
 767   const FGViewer * view = get_current_view();
 768   return (view == 0 ? 0.5f : view->getNear_m());
 769 }
 770
 771 void
 772 FGViewMgr::setNear_m (double near_m)
 773 {
 774   FGViewer * view = get_current_view();
 775   if (view != 0)
 776     view->setNear_m(near_m);
 777 }
 778
 779 void
 780 FGViewMgr::setViewAxisLong (double axis)
 781 {
 782   axis_long = axis;
 783 }
 784
 785 void
 786 FGViewMgr::setViewAxisLat (double axis)
 787 {
 788   axis_lat = axis;
 789 }
 790
 791 // reference frame orientation.
 792 // This is the view orientation you get when you have no
 793 // view offset, i.e. the offset operator is the identity.
 794 //
 795 // For example, in the familiar "cockpit lookfrom" view,
 796 // the reference frame is equal to the aircraft attitude,
 797 // i.e. it is the view looking towards 12:00 straight ahead.
 798 //
 799 // FIXME:  Somebody needs to figure out what is the reference
 800 // frame view for the other view modes.
 801 //
 802 // Conceptually, this quat represents a rotation relative
 803 // to the ECEF reference orientation, as described at
 804 //    http://www.av8n.com/physics/coords.htm#sec-orientation
 805 //
 806 // See the NOTE concerning reference orientations, below.
 807 //
 808 // The components of this quat are expressed in
 809 // the conventional aviation basis set,
 810 // i.e.  x=forward, y=starboard, z=bottom
 811 double FGViewMgr::getCurrentViewFrame_w() const{
 812   return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).w();
 813 }
 814 double FGViewMgr::getCurrentViewFrame_x() const{
 815   return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).x();
 816 }
 817 double FGViewMgr::getCurrentViewFrame_y() const{
 818   return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).y();
 819 }
 820 double FGViewMgr::getCurrentViewFrame_z() const{
 821   return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).z();
 822 }
 823
 824
 825 // view offset.
 826 // This rotation takes you from the aforementioned
 827 // reference frame view orientation to whatever
 828 // actual current view orientation is.
 829 //
 830 // The components of this quaternion are expressed in
 831 // the conventional aviation basis set,
 832 // i.e.  x=forward, y=starboard, z=bottom
 833 double FGViewMgr::getCurrentViewOrOffset_w() const{
 834    return current_view_or_offset.w();
 835 }
 836 double FGViewMgr::getCurrentViewOrOffset_x() const{
 837    return current_view_or_offset.x();
 838 }
 839 double FGViewMgr::getCurrentViewOrOffset_y() const{
 840    return current_view_or_offset.y();
 841 }
 842 double FGViewMgr::getCurrentViewOrOffset_z() const{
 843    return current_view_or_offset.z();
 844 }
 845
 846
 847 // current view orientation.
 848 // This is a rotation relative to the earth-centered (ec)
 849 // reference frame.
 850 //
 851 // NOTE: Here we remove a factor of fsb2sta so that
 852 // the components of this quat are displayed using the
 853 // conventional ECEF basis set.  This is *not* the way
 854 // the view orientation is stored in the views[] array,
 855 // but is easier for non-graphics hackers to understand.
 856 // If we did not remove this factor of fsb2sta here and
 857 // in getCurrentViewFrame, that would be equivalent to
 858 // the following peculiar reference orientation:
 859 // Suppose you are over the Gulf of Guinea, at (lat,lon) = (0,0).
 860 // Then the reference frame orientation can be achieved via:
 861 //    -- The aircraft X-axis (nose) headed south.
 862 //    -- The aircraft Y-axis (starboard wingtip) pointing up.
 863 //    -- The aircraft Z-axis (belly) pointing west.
 864 // To say the same thing in other words, and perhaps more to the
 865 // point:  If we use the OpenGL camera orientation conventions,
 866 // i.e. Xprime=starboard, Yprime=top, Zprime=aft, then the
 867 // aforementioned peculiar reference orientation at (lat,lon)
 868 //  = (0,0) can be described as:
 869 //    -- aircraft Xprime axis (starboard) pointed up
 870 //    -- aircraft Yprime axis (top) pointed east
 871 //    -- aircraft Zprime axis (aft) pointed north
 872 // meaning the OpenGL axes are aligned with the ECEF axes.
 873 double FGViewMgr::getCurrentViewOrientation_w() const{
 874   return (current_view_orientation * conj(fsb2sta())).w();
 875 }
 876 double FGViewMgr::getCurrentViewOrientation_x() const{
 877   return (current_view_orientation * conj(fsb2sta())).x();
 878 }
 879 double FGViewMgr::getCurrentViewOrientation_y() const{
 880   return (current_view_orientation * conj(fsb2sta())).y();
 881 }
 882 double FGViewMgr::getCurrentViewOrientation_z() const{
 883   return (current_view_orientation * conj(fsb2sta())).z();
 884 }
 885
 886 void
 887 FGViewMgr::do_axes ()
 888 {
 889                                 // Take no action when hat is centered
 890   if ( ( axis_long <  0.01 ) &&
 891        ( axis_long > -0.01 ) &&
 892        ( axis_lat  <  0.01 ) &&
 893        ( axis_lat  > -0.01 )
 894      )
 895     return;
 896
 897   double viewDir = 999;
 898
 899   /* Do all the quick and easy cases */
 900   if (axis_long < 0) {          // Longitudinal axis forward
 901     if (axis_lat == axis_long)
 902       viewDir = fgGetDouble("/sim/view/config/front-left-direction-deg");
 903     else if (axis_lat == - axis_long)
 904       viewDir = fgGetDouble("/sim/view/config/front-right-direction-deg");
 905     else if (axis_lat == 0)
 906       viewDir = fgGetDouble("/sim/view/config/front-direction-deg");
 907   } else if (axis_long > 0) {   // Longitudinal axis backward
 908     if (axis_lat == - axis_long)
 909       viewDir = fgGetDouble("/sim/view/config/back-left-direction-deg");
 910     else if (axis_lat == axis_long)
 911       viewDir = fgGetDouble("/sim/view/config/back-right-direction-deg");
 912     else if (axis_lat == 0)
 913       viewDir = fgGetDouble("/sim/view/config/back-direction-deg");
 914   } else if (axis_long == 0) {  // Longitudinal axis neutral
 915     if (axis_lat < 0)
 916       viewDir = fgGetDouble("/sim/view/config/left-direction-deg");
 917     else if (axis_lat > 0)
 918       viewDir = fgGetDouble("/sim/view/config/right-direction-deg");
 919     else return; /* And assertion failure maybe? */
 920   }
 921
 922                                 // Do all the difficult cases
 923   if ( viewDir > 900 )
 924     viewDir = SGD_RADIANS_TO_DEGREES * atan2 ( -axis_lat, -axis_long );
 925   if ( viewDir < -1 ) viewDir += 360;
 926
 927   get_current_view()->setGoalHeadingOffset_deg(viewDir);
 928 }