1 // viewmgr.cxx -- class for managing all the views in the flightgear world.
3 // Written by Curtis Olson, started October 2000.
4 // partially rewritten by Jim Wilson March 2002
6 // Copyright (C) 2000 Curtis L. Olson - http://www.flightgear.org/~curt
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.
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.
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.
28 #include "viewmgr.hxx"
30 #include <string.h> // strcmp
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>
39 FGViewMgr::FGViewMgr( void ) :
42 view_number(fgGetNode("/sim/current-view/view-number", true)),
43 config_list(fgGetNode("/sim", true)->getChildren("view")),
46 smgr = globals->get_soundmgr();
50 FGViewMgr::~FGViewMgr( void ) {
56 double aspect_ratio_multiplier
57 = fgGetDouble("/sim/current-view/aspect-ratio-multiplier");
59 for (unsigned int i = 0; i < config_list.size(); i++) {
60 SGPropertyNode *n = config_list[i];
62 // find out if this is an internal view (e.g. in cockpit, low near plane)
63 bool internal = n->getBoolValue("internal", false);
66 // this is assumed to be an aircraft model...we will need to read
67 // model-from-type as well.
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");
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");
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);
84 double fov_deg = n->getDoubleValue("config/default-field-of-view-deg");
85 double near_m = n->getDoubleValue("config/ground-level-nearplane-m");
87 // supporting two types "lookat" = 1 and "lookfrom" = 0
88 const char *type = n->getStringValue("type");
89 if (!strcmp(type, "lookat")) {
91 bool at_model = n->getBoolValue("config/at-model");
92 int at_model_index = n->getIntValue("config/at-model-idx");
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");
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");
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 ));
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 ));
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];
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"));
144 double fov_deg = n->getDoubleValue("config/default-field-of-view-deg");
147 fgSetDouble("/sim/current-view/field-of-view", fov_deg);
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"));
160 typedef double (FGViewMgr::*double_getter)() const;
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");
191 fgTie("/sim/current-view/view-number", this,
192 &FGViewMgr::getView, &FGViewMgr::setView);
193 fgSetArchivable("/sim/current-view/view-number", FALSE);
195 fgTie("/sim/current-view/axes/long", this,
196 (double_getter)0, &FGViewMgr::setViewAxisLong);
197 fgSetArchivable("/sim/current-view/axes/long");
199 fgTie("/sim/current-view/axes/lat", this,
200 (double_getter)0, &FGViewMgr::setViewAxisLat);
201 fgSetArchivable("/sim/current-view/axes/lat");
203 fgTie("/sim/current-view/field-of-view", this,
204 &FGViewMgr::getFOV_deg, &FGViewMgr::setFOV_deg);
205 fgSetArchivable("/sim/current-view/field-of-view");
207 fgTie("/sim/current-view/aspect-ratio-multiplier", this,
208 &FGViewMgr::getARM_deg, &FGViewMgr::setARM_deg);
209 fgSetArchivable("/sim/current-view/field-of-view");
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");
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]));
220 // for automatic untying:
221 #define x(str) ((void)tied_props.push_back(str), str)
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);
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);
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);
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");
272 list<const char*>::const_iterator it;
273 for (it = tied_props.begin(); it != tied_props.end(); it++){
280 FGViewMgr::update (double dt)
283 FGViewer *loop_view = (FGViewer *)get_current_view();
284 if (loop_view == 0) return;
286 SGPropertyNode *n = config_list[current];
287 double lon_deg, lat_deg, alt_ft, roll_deg, pitch_deg, heading_deg;
289 // Set up view location and orientation
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"));
299 loop_view->setPosition(lon_deg, lat_deg, alt_ft);
300 loop_view->setOrientation(roll_deg, pitch_deg, heading_deg);
302 // force recalc in viewer
303 loop_view->set_dirty();
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"));
316 loop_view->setTargetPosition(lon_deg, lat_deg, alt_ft);
317 loop_view->setTargetOrientation(roll_deg, pitch_deg, heading_deg);
319 loop_view->set_dirty();
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"));
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"));
331 current_view_orientation = loop_view->getViewOrientation();
332 current_view_or_offset = loop_view->getViewOrientationOffset();
334 // Update the current view
336 loop_view->update(dt);
337 abs_viewer_position = loop_view->getViewPosition();
339 // update audio listener values
340 // set the viewer posotion in Cartesian coordinates in meters
341 smgr->set_position( SGVec3d::fromGeod(loop_view->getPosition()) );
342 smgr->set_position_offset( loop_view->getOffset_m() );
343 smgr->set_orientation( current_view_orientation );
345 // get the model velocity
346 SGVec3f velocity = SGVec3f::zeros();
347 if ( !stationary() ) {
348 velocity = globals->get_aircraft_model()->getVelocity();
350 smgr->set_velocity(velocity);
354 FGViewMgr::copyToCurrent()
356 SGPropertyNode *n = config_list[current];
357 fgSetString("/sim/current-view/name", n->getStringValue("name"));
358 fgSetString("/sim/current-view/type", n->getStringValue("type"));
360 // copy certain view config data for default values
361 fgSetDouble("/sim/current-view/config/heading-offset-deg",
362 n->getDoubleValue("config/default-heading-offset-deg"));
363 fgSetDouble("/sim/current-view/config/pitch-offset-deg",
364 n->getDoubleValue("config/pitch-offset-deg"));
365 fgSetDouble("/sim/current-view/config/roll-offset-deg",
366 n->getDoubleValue("config/roll-offset-deg"));
367 fgSetDouble("/sim/current-view/config/default-field-of-view-deg",
368 n->getDoubleValue("config/default-field-of-view-deg"));
369 fgSetBool("/sim/current-view/config/from-model",
370 n->getBoolValue("config/from-model"));
373 fgSetDouble("/sim/current-view/x-offset-m", getViewXOffset_m());
374 fgSetDouble("/sim/current-view/y-offset-m", getViewYOffset_m());
375 fgSetDouble("/sim/current-view/z-offset-m", getViewZOffset_m());
377 fgSetDouble("/sim/current-view/goal-heading-offset-deg",
378 get_current_view()->getGoalHeadingOffset_deg());
379 fgSetDouble("/sim/current-view/goal-pitch-offset-deg",
380 get_current_view()->getGoalPitchOffset_deg());
381 fgSetDouble("/sim/current-view/goal-roll-offset-deg",
382 get_current_view()->getRollOffset_deg());
383 fgSetDouble("/sim/current-view/heading-offset-deg",
384 get_current_view()->getHeadingOffset_deg());
385 fgSetDouble("/sim/current-view/pitch-offset-deg",
386 get_current_view()->getPitchOffset_deg());
387 fgSetDouble("/sim/current-view/roll-offset-deg",
388 get_current_view()->getRollOffset_deg());
389 fgSetDouble("/sim/current-view/target-x-offset-m",
390 get_current_view()->getTargetXOffset_m());
391 fgSetDouble("/sim/current-view/target-y-offset-m",
392 get_current_view()->getTargetYOffset_m());
393 fgSetDouble("/sim/current-view/target-z-offset-m",
394 get_current_view()->getTargetZOffset_m());
395 fgSetBool("/sim/current-view/internal",
396 get_current_view()->getInternal());
399 void FGViewMgr::clear()
405 FGViewMgr::get_current_view()
407 if ( current < (int)views.size() ) {
408 return views[current];
415 FGViewMgr::get_current_view() const
417 if ( current < (int)views.size() ) {
418 return views[current];
426 FGViewMgr::get_view( int i )
428 if ( i < 0 ) { i = 0; }
429 if ( i >= (int)views.size() ) { i = views.size() - 1; }
434 FGViewMgr::get_view( int i ) const
436 if ( i < 0 ) { i = 0; }
437 if ( i >= (int)views.size() ) { i = views.size() - 1; }
442 FGViewMgr::next_view()
444 setView((current+1 < (int)views.size()) ? (current + 1) : 0);
445 view_number->fireValueChanged();
446 return views[current];
450 FGViewMgr::prev_view()
452 setView((0 < current) ? (current - 1) : (views.size() - 1));
453 view_number->fireValueChanged();
454 return views[current];
458 FGViewMgr::add_view( FGViewer * v )
465 FGViewMgr::getViewHeadingOffset_deg () const
467 const FGViewer * view = get_current_view();
468 return (view == 0 ? 0 : view->getHeadingOffset_deg());
472 FGViewMgr::setViewHeadingOffset_deg (double offset)
474 FGViewer * view = get_current_view();
476 view->setGoalHeadingOffset_deg(offset);
477 view->setHeadingOffset_deg(offset);
482 FGViewMgr::getViewGoalHeadingOffset_deg () const
484 const FGViewer * view = get_current_view();
485 return (view == 0 ? 0 : view->getGoalHeadingOffset_deg());
489 FGViewMgr::setViewGoalHeadingOffset_deg (double offset)
491 FGViewer * view = get_current_view();
493 view->setGoalHeadingOffset_deg(offset);
497 FGViewMgr::getViewPitchOffset_deg () const
499 const FGViewer * view = get_current_view();
500 return (view == 0 ? 0 : view->getPitchOffset_deg());
504 FGViewMgr::setViewPitchOffset_deg (double tilt)
506 FGViewer * view = get_current_view();
508 view->setGoalPitchOffset_deg(tilt);
509 view->setPitchOffset_deg(tilt);
514 FGViewMgr::getGoalViewPitchOffset_deg () const
516 const FGViewer * view = get_current_view();
517 return (view == 0 ? 0 : view->getGoalPitchOffset_deg());
521 FGViewMgr::setGoalViewPitchOffset_deg (double tilt)
523 FGViewer * view = get_current_view();
525 view->setGoalPitchOffset_deg(tilt);
529 FGViewMgr::getViewRollOffset_deg () const
531 const FGViewer * view = get_current_view();
532 return (view == 0 ? 0 : view->getRollOffset_deg());
536 FGViewMgr::setViewRollOffset_deg (double tilt)
538 FGViewer * view = get_current_view();
540 view->setGoalRollOffset_deg(tilt);
541 view->setRollOffset_deg(tilt);
546 FGViewMgr::getGoalViewRollOffset_deg () const
548 const FGViewer * view = get_current_view();
549 return (view == 0 ? 0 : view->getGoalRollOffset_deg());
553 FGViewMgr::setGoalViewRollOffset_deg (double tilt)
555 FGViewer * view = get_current_view();
557 view->setGoalRollOffset_deg(tilt);
561 FGViewMgr::getViewXOffset_m () const
563 const FGViewer * view = get_current_view();
565 return ((FGViewer *)view)->getXOffset_m();
572 FGViewMgr::setViewXOffset_m (double x)
574 FGViewer * view = get_current_view();
576 view->setXOffset_m(x);
581 FGViewMgr::getViewYOffset_m () const
583 const FGViewer * view = get_current_view();
585 return ((FGViewer *)view)->getYOffset_m();
592 FGViewMgr::setViewYOffset_m (double y)
594 FGViewer * view = get_current_view();
596 view->setYOffset_m(y);
601 FGViewMgr::getViewZOffset_m () const
603 const FGViewer * view = get_current_view();
605 return ((FGViewer *)view)->getZOffset_m();
612 FGViewMgr::setViewZOffset_m (double z)
614 FGViewer * view = get_current_view();
616 view->setZOffset_m(z);
621 FGViewMgr::stationary () const
623 const FGViewer * view = get_current_view();
625 if (((FGViewer *)view)->getXOffset_m() == 0.0 &&
626 ((FGViewer *)view)->getYOffset_m() == 0.0 &&
627 ((FGViewer *)view)->getZOffset_m() == 0.0)
635 FGViewMgr::getViewTargetXOffset_m () const
637 const FGViewer * view = get_current_view();
639 return ((FGViewer *)view)->getTargetXOffset_m();
646 FGViewMgr::setViewTargetXOffset_m (double x)
648 FGViewer * view = get_current_view();
650 view->setTargetXOffset_m(x);
655 FGViewMgr::getViewTargetYOffset_m () const
657 const FGViewer * view = get_current_view();
659 return ((FGViewer *)view)->getTargetYOffset_m();
666 FGViewMgr::setViewTargetYOffset_m (double y)
668 FGViewer * view = get_current_view();
670 view->setTargetYOffset_m(y);
675 FGViewMgr::getViewTargetZOffset_m () const
677 const FGViewer * view = get_current_view();
679 return ((FGViewer *)view)->getTargetZOffset_m();
686 FGViewMgr::setViewTargetZOffset_m (double z)
688 FGViewer * view = get_current_view();
690 view->setTargetZOffset_m(z);
695 FGViewMgr::getView () const
701 FGViewMgr::setView (int newview)
703 // negative numbers -> set view with node index -newview
705 for (int i = 0; i < (int)config_list.size(); i++) {
706 int index = -config_list[i]->getIndex();
707 if (index == newview)
714 // if newview number too low wrap to last view...
716 newview = (int)views.size() - 1;
718 // if newview number to high wrap to zero...
719 if (newview >= (int)views.size())
727 // Copy the fdm's position into the SGLocation which is shared with
729 globals->get_aircraft_model()->update(0);
736 FGViewMgr::getFOV_deg () const
738 const FGViewer * view = get_current_view();
739 return (view == 0 ? 0 : view->get_fov());
743 FGViewMgr::setFOV_deg (double fov)
745 FGViewer * view = get_current_view();
751 FGViewMgr::getARM_deg () const
753 const FGViewer * view = get_current_view();
754 return (view == 0 ? 0 : view->get_aspect_ratio_multiplier());
758 FGViewMgr::setARM_deg (double aspect_ratio_multiplier)
760 FGViewer * view = get_current_view();
762 view->set_aspect_ratio_multiplier(aspect_ratio_multiplier);
766 FGViewMgr::getNear_m () const
768 const FGViewer * view = get_current_view();
769 return (view == 0 ? 0.5f : view->getNear_m());
773 FGViewMgr::setNear_m (double near_m)
775 FGViewer * view = get_current_view();
777 view->setNear_m(near_m);
781 FGViewMgr::setViewAxisLong (double axis)
787 FGViewMgr::setViewAxisLat (double axis)
792 // reference frame orientation.
793 // This is the view orientation you get when you have no
794 // view offset, i.e. the offset operator is the identity.
796 // For example, in the familiar "cockpit lookfrom" view,
797 // the reference frame is equal to the aircraft attitude,
798 // i.e. it is the view looking towards 12:00 straight ahead.
800 // FIXME: Somebody needs to figure out what is the reference
801 // frame view for the other view modes.
803 // Conceptually, this quat represents a rotation relative
804 // to the ECEF reference orientation, as described at
805 // http://www.av8n.com/physics/coords.htm#sec-orientation
807 // See the NOTE concerning reference orientations, below.
809 // The components of this quat are expressed in
810 // the conventional aviation basis set,
811 // i.e. x=forward, y=starboard, z=bottom
812 double FGViewMgr::getCurrentViewFrame_w() const{
813 return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).w();
815 double FGViewMgr::getCurrentViewFrame_x() const{
816 return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).x();
818 double FGViewMgr::getCurrentViewFrame_y() const{
819 return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).y();
821 double FGViewMgr::getCurrentViewFrame_z() const{
822 return ((current_view_orientation*conj(fsb2sta())*conj(current_view_or_offset))).z();
827 // This rotation takes you from the aforementioned
828 // reference frame view orientation to whatever
829 // actual current view orientation is.
831 // The components of this quaternion are expressed in
832 // the conventional aviation basis set,
833 // i.e. x=forward, y=starboard, z=bottom
834 double FGViewMgr::getCurrentViewOrOffset_w() const{
835 return current_view_or_offset.w();
837 double FGViewMgr::getCurrentViewOrOffset_x() const{
838 return current_view_or_offset.x();
840 double FGViewMgr::getCurrentViewOrOffset_y() const{
841 return current_view_or_offset.y();
843 double FGViewMgr::getCurrentViewOrOffset_z() const{
844 return current_view_or_offset.z();
848 // current view orientation.
849 // This is a rotation relative to the earth-centered (ec)
852 // NOTE: Here we remove a factor of fsb2sta so that
853 // the components of this quat are displayed using the
854 // conventional ECEF basis set. This is *not* the way
855 // the view orientation is stored in the views[] array,
856 // but is easier for non-graphics hackers to understand.
857 // If we did not remove this factor of fsb2sta here and
858 // in getCurrentViewFrame, that would be equivalent to
859 // the following peculiar reference orientation:
860 // Suppose you are over the Gulf of Guinea, at (lat,lon) = (0,0).
861 // Then the reference frame orientation can be achieved via:
862 // -- The aircraft X-axis (nose) headed south.
863 // -- The aircraft Y-axis (starboard wingtip) pointing up.
864 // -- The aircraft Z-axis (belly) pointing west.
865 // To say the same thing in other words, and perhaps more to the
866 // point: If we use the OpenGL camera orientation conventions,
867 // i.e. Xprime=starboard, Yprime=top, Zprime=aft, then the
868 // aforementioned peculiar reference orientation at (lat,lon)
869 // = (0,0) can be described as:
870 // -- aircraft Xprime axis (starboard) pointed up
871 // -- aircraft Yprime axis (top) pointed east
872 // -- aircraft Zprime axis (aft) pointed north
873 // meaning the OpenGL axes are aligned with the ECEF axes.
874 double FGViewMgr::getCurrentViewOrientation_w() const{
875 return (current_view_orientation * conj(fsb2sta())).w();
877 double FGViewMgr::getCurrentViewOrientation_x() const{
878 return (current_view_orientation * conj(fsb2sta())).x();
880 double FGViewMgr::getCurrentViewOrientation_y() const{
881 return (current_view_orientation * conj(fsb2sta())).y();
883 double FGViewMgr::getCurrentViewOrientation_z() const{
884 return (current_view_orientation * conj(fsb2sta())).z();
888 FGViewMgr::do_axes ()
890 // Take no action when hat is centered
891 if ( ( axis_long < 0.01 ) &&
892 ( axis_long > -0.01 ) &&
893 ( axis_lat < 0.01 ) &&
898 double viewDir = 999;
900 /* Do all the quick and easy cases */
901 if (axis_long < 0) { // Longitudinal axis forward
902 if (axis_lat == axis_long)
903 viewDir = fgGetDouble("/sim/view/config/front-left-direction-deg");
904 else if (axis_lat == - axis_long)
905 viewDir = fgGetDouble("/sim/view/config/front-right-direction-deg");
906 else if (axis_lat == 0)
907 viewDir = fgGetDouble("/sim/view/config/front-direction-deg");
908 } else if (axis_long > 0) { // Longitudinal axis backward
909 if (axis_lat == - axis_long)
910 viewDir = fgGetDouble("/sim/view/config/back-left-direction-deg");
911 else if (axis_lat == axis_long)
912 viewDir = fgGetDouble("/sim/view/config/back-right-direction-deg");
913 else if (axis_lat == 0)
914 viewDir = fgGetDouble("/sim/view/config/back-direction-deg");
915 } else if (axis_long == 0) { // Longitudinal axis neutral
917 viewDir = fgGetDouble("/sim/view/config/left-direction-deg");
918 else if (axis_lat > 0)
919 viewDir = fgGetDouble("/sim/view/config/right-direction-deg");
920 else return; /* And assertion failure maybe? */
923 // Do all the difficult cases
925 viewDir = SGD_RADIANS_TO_DEGREES * atan2 ( -axis_lat, -axis_long );
926 if ( viewDir < -1 ) viewDir += 360;
928 get_current_view()->setGoalHeadingOffset_deg(viewDir);