src/Viewer/viewmgr.hxx

   1 // viewmgr.hxx -- class for managing all the views in the flightgear world.
   2 //
   3 // Written by Curtis Olson, started October 2000.
   4 //
   5 // Copyright (C) 2000  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 #ifndef _VIEWMGR_HXX
  25 #define _VIEWMGR_HXX
  26
  27 #include <vector>
  28
  29 #include <simgear/compiler.h>
  30 #include <simgear/structure/subsystem_mgr.hxx>
  31 #include <simgear/props/props.hxx>
  32 #include <simgear/props/tiedpropertylist.hxx>
  33 #include <simgear/math/SGMath.hxx>
  34
  35 // forward decls
  36 class FGViewer;
  37 typedef SGSharedPtr<FGViewer> FGViewerPtr;
  38
  39 // Define a structure containing view information
  40 class FGViewMgr : public SGSubsystem
  41 {
  42
  43 public:
  44
  45     // Constructor
  46     FGViewMgr( void );
  47
  48     // Destructor
  49     ~FGViewMgr( void );
  50
  51     virtual void init ();
  52     virtual void bind ();
  53     virtual void unbind ();
  54     virtual void update (double dt);
  55     virtual void reinit ();
  56
  57     // getters
  58     inline int size() const { return views.size(); }
  59     inline int get_current() const { return current; }
  60
  61     FGViewer *get_current_view();
  62     const FGViewer *get_current_view() const;
  63
  64     FGViewer *get_view( int i );
  65     const FGViewer *get_view( int i ) const;
  66
  67     FGViewer *next_view();
  68     FGViewer *prev_view();
  69
  70     // setters
  71     void clear();
  72
  73     void add_view( FGViewer * v );
  74
  75 private:
  76     void do_bind();
  77
  78     simgear::TiedPropertyList _tiedProperties;
  79
  80     double axis_long;
  81     double axis_lat;
  82
  83     void do_axes ();
  84
  85     //  callbacks in manager to access viewer methods
  86     double getViewHeadingOffset_deg () const;
  87     void setViewHeadingOffset_deg (double offset);
  88     double getViewGoalHeadingOffset_deg () const;
  89     void setViewGoalHeadingOffset_deg (double offset);
  90     double getViewPitchOffset_deg () const;
  91     void setViewPitchOffset_deg (double tilt);
  92     double getGoalViewPitchOffset_deg () const;
  93     void setGoalViewRollOffset_deg (double tilt);
  94     double getViewRollOffset_deg () const;
  95     void setViewRollOffset_deg (double tilt);
  96     double getGoalViewRollOffset_deg () const;
  97     void setGoalViewPitchOffset_deg (double tilt);
  98     double getViewXOffset_m () const;
  99     void setViewXOffset_m (double x);
 100     double getViewYOffset_m () const;
 101     void setViewYOffset_m (double y);
 102     double getViewZOffset_m () const;
 103     void setViewZOffset_m (double z);
 104     double getViewTargetXOffset_m () const;
 105     void setViewTargetXOffset_m (double x);
 106     double getViewTargetYOffset_m () const;
 107     void setViewTargetYOffset_m (double y);
 108     double getViewTargetZOffset_m () const;
 109     void setViewTargetZOffset_m (double z);
 110     double getFOV_deg () const;
 111     void setFOV_deg (double fov);
 112     double getARM_deg () const; // Aspect Ratio Multiplier
 113     void setARM_deg (double fov);
 114     double getNear_m () const;
 115     void setNear_m (double near_m);
 116     void setViewAxisLong (double axis);
 117     void setViewAxisLat (double axis);
 118     int getView () const;
 119     void setView (int newview);
 120
 121     double getViewLon_deg() const;
 122     double getViewLat_deg() const;
 123     double getViewElev_ft() const;
 124
 125 // quaternion accessors, for debugging:
 126     double getCurrentViewOrientation_w() const;
 127     double getCurrentViewOrientation_x() const;
 128     double getCurrentViewOrientation_y() const;
 129     double getCurrentViewOrientation_z() const;
 130     double getCurrentViewOrOffset_w() const;
 131     double getCurrentViewOrOffset_x() const;
 132     double getCurrentViewOrOffset_y() const;
 133     double getCurrentViewOrOffset_z() const;
 134     double getCurrentViewFrame_w() const;
 135     double getCurrentViewFrame_x() const;
 136     double getCurrentViewFrame_y() const;
 137     double getCurrentViewFrame_z() const;
 138
 139     // copies current offset settings to current-view path...
 140     void copyToCurrent ();
 141
 142     bool inited;
 143     SGPropertyNode_ptr view_number;
 144     std::vector<SGPropertyNode_ptr> config_list;
 145     typedef std::vector<FGViewerPtr> viewer_list;
 146     viewer_list views;
 147     SGVec3d abs_viewer_position;
 148
 149     int current;
 150     SGQuatd current_view_orientation, current_view_or_offset;
 151
 152     SGPropertyNode_ptr current_x_offs, current_y_offs, current_z_offs;
 153     SGPropertyNode_ptr target_x_offs, target_y_offs, target_z_offs;
 154 };
 155
 156 // This takes the conventional aviation XYZ body system
 157 // i.e.  x=forward, y=starboard, z=bottom
 158 // which is widely used in FGFS
 159 // and rotates it into the OpenGL camera system
 160 // i.e. Xprime=starboard, Yprime=top, Zprime=aft.
 161 inline const SGQuatd fsb2sta()
 162 {
 163     return SGQuatd(-0.5, -0.5, 0.5, 0.5);
 164 }
 165
 166 #endif // _VIEWMGR_HXX