X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FMain%2Fviewer.hxx;h=3f9c95e2917ae8a58eed703198fb2fa64c5f1349;hb=09d4176e963be04dec40943083e369081b8f7a18;hp=19d5f2563c0500f92a3eb44170888b83270d15b9;hpb=152a5902c82013c75ba4b09149523867b8d9d136;p=flightgear.git

diff --git a/src/Main/viewer.hxx b/src/Main/viewer.hxx
index 19d5f2563..3f9c95e29 100644
--- a/src/Main/viewer.hxx
+++ b/src/Main/viewer.hxx
@@ -2,6 +2,8 @@
 //
 // Written by Curtis Olson, started August 1997.
 //                          overhaul started October 2000.
+//   partially rewritten by Jim Wilson jim@kelcomaine.com using interface
+//                          by David Megginson March 2002
 //
 // Copyright (C) 1997 - 2000  Curtis L. Olson  - curt@flightgear.org
 //
@@ -31,175 +33,389 @@
 #endif                                   
 
 #include <simgear/compiler.h>
-#include <simgear/math/point3d.hxx>
-#include <simgear/timing/sg_time.hxx>
-
-#include <list>
+#include <simgear/constants.h>
+#include <simgear/structure/subsystem_mgr.hxx>
+#include <simgear/scene/model/location.hxx>
 
 #include <plib/sg.h>		// plib include
 
-#include <FDM/flight.hxx>
-#include <Time/light.hxx>
+#define FG_FOV_MIN 0.1
+#define FG_FOV_MAX 179.9
 
+enum fgViewType {
+ FG_LOOKFROM = 0,
+ FG_LOOKAT = 1
+};
 
-FG_USING_STD(list);
+// Define a structure containing view information
+class FGViewer : public SGSubsystem {
 
+public:
 
-#define FG_FOV_MIN 0.1
-#define FG_FOV_MAX 179.9
+    enum fgScalingType {  // nominal Field Of View actually applies to ...
+	FG_SCALING_WIDTH,       // window width
+	FG_SCALING_MAX          // max(width, height)
+	// FG_SCALING_G_MEAN,      // geometric_mean(width, height)
+	// FG_SCALING_INDEPENDENT  // whole screen
+    };
 
+    // Constructor
+    FGViewer( fgViewType Type, bool from_model, int from_model_index,
+              bool at_model, int at_model_index,
+              double damp_roll, double damp_pitch, double damp_heading,
+              double x_offset_m, double y_offset_m, double z_offset_m,
+              double heading_offset_deg, double pitch_offset_deg,
+              double roll_offset_deg, double fov_deg,
+              double target_x_offset_m, double target_y_offset_m,
+              double target_z_offset_m, double near_m, bool internal );
+
+    // Destructor
+    virtual ~FGViewer( void );
+
+    //////////////////////////////////////////////////////////////////////
+    // Part 1: standard SGSubsystem implementation.
+    //////////////////////////////////////////////////////////////////////
+
+    virtual void init ();
+    virtual void bind ();
+    virtual void unbind ();
+    void update (double dt);
+
+
+    //////////////////////////////////////////////////////////////////////
+    // Part 2: user settings.
+    //////////////////////////////////////////////////////////////////////
+
+    virtual fgViewType getType() const { return _type; }
+    virtual void setType( int type );
+
+    virtual bool getInternal() const { return _internal; }
+    virtual void setInternal( bool internal );
+
+    // Reference geodetic position of view from position...
+    //   These are the actual aircraft position (pilot in
+    //   pilot view, model in model view).
+    //   FIXME: the model view position (ie target positions) 
+    //   should be in the model class.
+    virtual double getLongitude_deg () const { return _lon_deg; }
+    virtual double getLatitude_deg () const { return _lat_deg; }
+    virtual double getAltitudeASL_ft () const { return _alt_ft; }
+    virtual void setLongitude_deg (double lon_deg);
+    virtual void setLatitude_deg (double lat_deg);
+    virtual void setAltitude_ft (double alt_ft);
+    virtual void setPosition (double lon_deg, double lat_deg, double alt_ft);
+
+    // Reference geodetic target position...
+    virtual double getTargetLongitude_deg () const { return _target_lon_deg; }
+    virtual double getTargetLatitude_deg () const { return _target_lat_deg; }
+    virtual double getTargetAltitudeASL_ft () const { return _target_alt_ft; }
+    virtual void setTargetLongitude_deg (double lon_deg);
+    virtual void setTargetLatitude_deg (double lat_deg);
+    virtual void setTargetAltitude_ft (double alt_ft);
+    virtual void setTargetPosition (double lon_deg, double lat_deg, double alt_ft);
+
+
+
+
+    // Position offsets from reference
+    //   These offsets position they "eye" in the scene according to a given
+    //   location.  For example in pilot view they are used to position the 
+    //   head inside the aircraft.
+    //   Note that in pilot view these are applied "before" the orientation 
+    //   rotations (see below) so that the orientation rotations have the 
+    //   effect of the pilot staying in his seat and "looking out" in 
+    //   different directions.
+    //   In chase view these are applied "after" the application of the 
+    //   orientation rotations listed below.  This has the effect of the 
+    //   eye moving around and "looking at" the object (model) from 
+    //   different angles.
+    virtual double getXOffset_m () const { return _x_offset_m; }
+    virtual double getYOffset_m () const { return _y_offset_m; }
+    virtual double getZOffset_m () const { return _z_offset_m; }
+    virtual double getTargetXOffset_m () const { return _target_x_offset_m; }
+    virtual double getTargetYOffset_m () const { return _target_y_offset_m; }
+    virtual double getTargetZOffset_m () const { return _target_z_offset_m; }
+    virtual void setXOffset_m (double x_offset_m);
+    virtual void setYOffset_m (double y_offset_m);
+    virtual void setZOffset_m (double z_offset_m);
+    virtual void setTargetXOffset_m (double x_offset_m);
+    virtual void setTargetYOffset_m (double y_offset_m);
+    virtual void setTargetZOffset_m (double z_offset_m);
+    virtual void setPositionOffsets (double x_offset_m,
+				     double y_offset_m,
+				     double z_offset_m);
+
+
+
+
+    // Reference orientation rotations...
+    //   These are rotations that represent the plane attitude effect on
+    //   the view (in Pilot view).  IE The view frustrum rotates as the plane
+    //   turns, pitches, and rolls.
+    //   In model view (lookat/chaseview) these end up changing the angle that
+    //   the eye is looking at the ojbect (ie the model).
+    //   FIXME: the FGModel class should have its own version of these so that
+    //   it can generate it's own model rotations.
+    virtual double getRoll_deg () const { return _roll_deg; }
+    virtual double getPitch_deg () const {return _pitch_deg; }
+    virtual double getHeading_deg () const {return _heading_deg; }
+    virtual void setRoll_deg (double roll_deg);
+    virtual void setPitch_deg (double pitch_deg);
+    virtual void setHeading_deg (double heading_deg);
+    virtual void setOrientation (double roll_deg, double pitch_deg, double heading_deg);
+    virtual double getTargetRoll_deg () const { return _target_roll_deg; }
+    virtual double getTargetPitch_deg () const {return _target_pitch_deg; }
+    virtual double getTargetHeading_deg () const {return _target_heading_deg; }
+    virtual void setTargetRoll_deg (double roll_deg);
+    virtual void setTargetPitch_deg (double pitch_deg);
+    virtual void setTargetHeading_deg (double heading_deg);
+    virtual void setTargetOrientation (double roll_deg, double pitch_deg, double heading_deg);
+
+
+
+
+    // Orientation offsets rotations from reference orientation.
+    // Goal settings are for smooth transition from prior 
+    // offset when changing view direction.
+    //   These offsets are in ADDITION to the orientation rotations listed 
+    //   above.
+    //   In pilot view they are applied after the position offsets in order to
+    //   give the effect of the pilot looking around.
+    //   In lookat view they are applied before the position offsets so that
+    //   the effect is the eye moving around looking at the object (ie the model)
+    //   from different angles.
+    virtual double getRollOffset_deg () const { return _roll_offset_deg; }
+    virtual double getPitchOffset_deg () const { return _pitch_offset_deg; }
+    virtual double getHeadingOffset_deg () const { return _heading_offset_deg; }
+    virtual double getGoalRollOffset_deg () const { return _goal_roll_offset_deg; }
+    virtual double getGoalPitchOffset_deg () const { return _goal_pitch_offset_deg; }
+    virtual double getGoalHeadingOffset_deg () const {return _goal_heading_offset_deg; }
+    virtual void setRollOffset_deg (double roll_offset_deg);
+    virtual void setPitchOffset_deg (double pitch_offset_deg);
+    virtual void setHeadingOffset_deg (double heading_offset_deg);
+    virtual void setGoalRollOffset_deg (double goal_roll_offset_deg);
+    virtual void setGoalPitchOffset_deg (double goal_pitch_offset_deg);
+    virtual void setGoalHeadingOffset_deg (double goal_heading_offset_deg);
+    virtual void setOrientationOffsets (double roll_offset_deg,
+				     double heading_offset_deg,
+				     double pitch_offset_deg);
+
+
+
+    //////////////////////////////////////////////////////////////////////
+    // Part 3: output vectors and matrices in FlightGear coordinates.
+    //////////////////////////////////////////////////////////////////////
+
+    // Vectors and positions...
+
+    // Get zero view_pos
+    virtual float * get_view_pos() {if ( _dirty ) { recalc(); }	return _view_pos; }
+    // Get the absolute view position in fgfs coordinates.
+    virtual double * get_absolute_view_pos ();
+    // Get zero elev
+    virtual float * get_zero_elev() {if ( _dirty ) { recalc(); } return _zero_elev; }
+    // Get world up vector
+    virtual float *get_world_up() {if ( _dirty ) { recalc(); } return _world_up; }
+    // Get the relative (to scenery center) view position in fgfs coordinates.
+    virtual float * getRelativeViewPos ();
+    // Get the absolute zero-elevation view position in fgfs coordinates.
+    virtual float * getZeroElevViewPos ();
+    // Get surface east vector
+    virtual float *get_surface_east() {	if ( _dirty ) { recalc(); } return _surface_east; }
+    // Get surface south vector
+    virtual float *get_surface_south() {if ( _dirty ) { recalc(); } return _surface_south; }
+
+    // Matrices...
+    virtual const sgVec4 *get_VIEW() { if ( _dirty ) { recalc(); } return VIEW; }
+    virtual const sgVec4 *get_UP() { if ( _dirty ) { recalc(); } return UP; }
+
+    //////////////////////////////////////////////////////////////////////
+    // Part 4: View and frustrum data setters and getters
+    //////////////////////////////////////////////////////////////////////
+
+    virtual void set_fov( double fov_deg ) {
+	_fov_deg = fov_deg;
+    }
+    virtual double get_fov() const { return _fov_deg; }
+    virtual double get_h_fov();    // Get horizontal fov, in degrees.
+    virtual double get_v_fov();    // Get vertical fov, in degrees.
+
+    virtual void set_aspect_ratio( double r ) {
+	_aspect_ratio = r;
+    }
+    virtual double get_aspect_ratio() const { return _aspect_ratio; }
+
+    virtual double getNear_m () const { return _ground_level_nearplane_m; }
+    inline void setNear_m (double near_m) {
+        _ground_level_nearplane_m = near_m;
+    }
+
+    //////////////////////////////////////////////////////////////////////
+    // Part 5: misc setters and getters
+    //////////////////////////////////////////////////////////////////////
+
+    inline void set_dirty() { _dirty = true; }
+    inline void set_clean() { _dirty = false; }
+    
+    // return eye location...
+    virtual SGLocation * getSGLocation () const { return _location; }
 
-// Define a structure containing view information
-class FGViewer {
 
 private:
 
-    // the current view offset angle from forward (rotated about the
-    // view_up vector)
-    double view_offset;
+    //////////////////////////////////////////////////////////////////
+    // private data                                                 //
+    //////////////////////////////////////////////////////////////////
+
+    // flag forcing a recalc of derived view parameters
+    bool _dirty;
+
+    mutable sgdVec3 _absolute_view_pos;
+    mutable sgVec3 _relative_view_pos;
+    mutable sgVec3 _zero_elev_view_pos;
+
+    double _lon_deg;
+    double _lat_deg;
+    double _alt_ft;
+    double _target_lon_deg;
+    double _target_lat_deg;
+    double _target_alt_ft;
+
+    double _roll_deg;
+    double _pitch_deg;
+    double _heading_deg;
+    double _target_roll_deg;
+    double _target_pitch_deg;
+    double _target_heading_deg;
+
+    double _damp_sync;
+    double _damp_roll;
+    double _damp_pitch;
+    double _damp_heading;
+
+    double _damped_roll_deg;
+    double _damped_pitch_deg;
+    double _damped_heading_deg;
+
+    // Position offsets from FDM origin.  The X axis is positive
+    // out the tail, Y is out the right wing, and Z is positive up.
+    // distance in meters
+    double _x_offset_m;
+    double _y_offset_m;
+    double _z_offset_m;
 
-    // the goal view offset angle  (used for smooth view changes)
-    double goal_view_offset;
+    // Target offsets from FDM origin (for "lookat" targets) The X
+    // axis is positive out the tail, Y is out the right wing, and Z
+    // is positive up.  distance in meters
+    double _target_x_offset_m;
+    double _target_y_offset_m;
+    double _target_z_offset_m;
 
-    // flag forcing update of fov related stuff
-    bool update_fov;
-	
-    // fov of view is specified in the X direction, win_ratio is used to
-    // calculate the fov in the Y direction.  fov(y) = fov(x) * win_ratio
-    double win_ratio;
 
-    // width & height of window
-    // int winWidth, winHeight;
+    // orientation offsets from reference (_goal* are for smoothed transitions)
+    double _roll_offset_deg;
+    double _pitch_offset_deg;
+    double _heading_offset_deg;
+    double _goal_roll_offset_deg;
+    double _goal_pitch_offset_deg;
+    double _goal_heading_offset_deg;
 
-    // absolute view position in earth coordinates
-    Point3D abs_view_pos;
+    // used to set nearplane when at ground level for this view
+    double _ground_level_nearplane_m;
 
-    // view position in opengl world coordinates (this is the
-    // abs_view_pos translated to scenery.center)
-    Point3D view_pos;
+    fgViewType _type;
+    fgScalingType _scaling_type;
 
-    // pilot offset from center of gravity.  The X axis is positive
-    // out the tail, Y is out the right wing, and Z is positive up.
-    // Distances in meters of course.
-    sgVec3 pilot_offset;
+    // internal view (e.g. cockpit) flag
+    bool _internal;
 
-    // cartesion coordinates of current lon/lat if at sea level
-    // translated to scenery.center
-    Point3D cur_zero_elev;
+    // view is looking from a model
+    bool _from_model;
+    int _from_model_index;  // number of model (for multi model)
 
-    // vector in cartesian coordinates from current position to the
-    // postion on the earth's surface the sun is directly over
-    sgVec3 to_sun;
+    // view is looking at a model
+    bool _at_model;
+    int _at_model_index;  // number of model (for multi model)
 
-    // surface direction to go to head towards sun
-    sgVec3 surface_to_sun;
+    SGLocation * _location;
+    SGLocation * _target_location;
 
-    // vector in cartesian coordinates from current position to the
-    // postion on the earth's surface the moon is directly over
-    sgVec3 to_moon;
-  
-    // surface direction to go to head towards moon
-    sgVec3 surface_to_moon;
+    // the nominal field of view (angle, in degrees)
+    double _fov_deg; 
+
+    // ratio of window width and height; height = width * aspect_ratio
+    double _aspect_ratio;
+
+    bool _reverse_view_offset;
+
+    // view position in opengl world coordinates (this is the
+    // abs_view_pos translated to scenery.center)
+    sgVec3 _view_pos;
+
+    // cartesion coordinates of current lon/lat if at sea level
+    // translated to scenery.center
+    sgVec3 _zero_elev;
 
     // surface vector heading south
-    sgVec3 surface_south;
+    sgVec3 _surface_south;
 
     // surface vector heading east (used to unambiguously align sky
     // with sun)
-    sgVec3 surface_east;
+    sgVec3 _surface_east;
 
-    // local up vector (normal to the plane tangent to the earth's
+    // world up vector (normal to the plane tangent to the earth's
     // surface at the spot we are directly above
-    sgVec3 local_up;
+    sgVec3 _world_up;
 
     // up vector for the view (usually point straight up through the
     // top of the aircraft
-    sgVec3 view_up;
-
-    // the vector pointing straight out the nose of the aircraft
-    sgVec3 view_forward;
+    sgVec3 _view_up;
 
-    // Transformation matrix for eye coordinates to aircraft coordinates
-    // sgMat4 AIRCRAFT;
+    // sg versions of our friendly matrices
+    sgMat4 VIEW, UP;
+    sgMat4 LOCAL, ATLOCAL, TRANS, LARC_TO_SSG;
 
     // Transformation matrix for the view direction offset relative to
     // the AIRCRAFT matrix
     sgMat4 VIEW_OFFSET;
 
-    // sg versions of our friendly matrices
-    sgMat4 LOCAL, UP, VIEW_ROT, TRANS, VIEW, LARC_TO_SSG;
-
-public:
-
-    // Constructor
-    FGViewer( void );
-
-    // Destructor
-    ~FGViewer( void );
-
-    // Initialize a view class
-    void Init( void );
-
-    // Update the view volume, position, and orientation
-    void UpdateViewParams( const FGInterface& f );
-
-    // Flag to request that UpdateFOV() be called next time
-    // UpdateViewMath() is run.
-    inline void force_update_fov_math() { update_fov = true; }
-
-    // Update the view parameters
-    void UpdateViewMath( const FGInterface& f );
-
-    // Update the field of view coefficients
-    void UpdateFOV( const FGOptions *o );
-
-    // Transform a vector from world coordinates to the local plane
-    void CurrentNormalInLocalPlane(sgVec3 dst, sgVec3 src);
-
-    // accessor functions
-    inline double get_view_offset() const { return view_offset; }
-    inline void set_view_offset( double a ) { view_offset = a; }
-    inline void inc_view_offset( double amt ) { view_offset += amt; }
-    inline double get_goal_view_offset() const { return goal_view_offset; }
-    inline void set_goal_view_offset( double a) { goal_view_offset = a; }
-    inline double get_win_ratio() const { return win_ratio; }
-    inline void set_win_ratio( double r ) { win_ratio = r; }
-    // inline int get_winWidth() const { return winWidth; }
-    // inline void set_winWidth( int w ) { winWidth = w; }
-    // inline int get_winHeight() const { return winHeight; }
-    // inline void set_winHeight( int h ) { winHeight = h; }
-    inline Point3D get_abs_view_pos() const { return abs_view_pos; }
-    inline Point3D get_view_pos() const { return view_pos; }
-    inline float *get_pilot_offset() { return pilot_offset; }
-    inline void set_pilot_offset( float x, float y, float z ) {
-	sgSetVec3( pilot_offset, x, y, z );
-    }
-    inline Point3D get_cur_zero_elev() const { return cur_zero_elev; }
-    inline float *get_to_sun() { return to_sun; }
-    inline void set_to_sun( float x, float y, float z ) {
-	sgSetVec3( to_sun, x, y, z );
+    //////////////////////////////////////////////////////////////////
+    // private functions                                            //
+    //////////////////////////////////////////////////////////////////
+
+    void recalc ();
+    void recalcLookFrom();
+    void recalcLookAt();
+    void copyLocationData();
+    void updateFromModelLocation (SGLocation * location);
+    void updateAtModelLocation (SGLocation * location);
+    void recalcOurOwnLocation (SGLocation * location, double lon_deg, double lat_deg, double alt_ft,
+                 double roll_deg, double pitch_deg, double heading_deg);
+    void dampEyeData (double &roll_deg, double &pitch_deg, double &heading_deg);
+
+    // add to _heading_offset_deg
+    inline void incHeadingOffset_deg( double amt ) {
+	set_dirty();
+	_heading_offset_deg += amt;
     }
-    inline float *get_surface_to_sun() { return surface_to_sun; }
-    inline void set_surface_to_sun( float x, float y, float z) {
-	sgSetVec3( surface_to_sun, x, y, z );
+
+    // add to _pitch_offset_deg
+    inline void incPitchOffset_deg( double amt ) {
+	set_dirty();
+	_pitch_offset_deg += amt;
     }
-    inline float *get_to_moon() { return to_moon; }
-    inline void set_to_moon( float x, float y, float z) {
-	sgSetVec3( to_moon, x, y, z );
+
+    // add to _roll_offset_deg
+    inline void incRollOffset_deg( double amt ) {
+	set_dirty();
+	_roll_offset_deg += amt;
     }
-    inline float *get_surface_to_moon() { return surface_to_moon; }
-    inline void set_surface_to_moon( float x, float y, float z) {
-	sgSetVec3( surface_to_moon, x, y, z );
+
+    inline void set_reverse_view_offset( bool val ) {
+	_reverse_view_offset = val;
     }
-    inline float *get_surface_south() { return surface_south; }
-    inline float *get_surface_east() { return surface_east; }
-    inline float *get_local_up() { return local_up; }
-    inline float *get_view_forward() { return view_forward; }
 
-    inline const sgVec4 *get_VIEW() { return VIEW; }
-    inline const sgVec4 *get_VIEW_ROT() { return VIEW_ROT; }
 };
 
-#endif // _VIEWER_HXX
-
 
+#endif // _VIEWER_HXX