#endif
#include <simgear/compiler.h>
+#include <simgear/constants.h>
#include <plib/sg.h> // plib include
+#include "fgfs.hxx"
+
#define FG_FOV_MIN 0.1
#define FG_FOV_MAX 179.9
+/**
+ * Representation of a single viewpoint in the FlightGear world.
+ */
+class FGViewPoint
+{
+public:
+ FGViewPoint ();
+ virtual ~FGViewPoint ();
+
+ /**
+ * Set the geodetic position for the view point.
+ */
+ virtual void setPosition (double lon_deg, double lat_deg, double alt_ft);
+
+
+ /**
+ * Get the longitude in degrees.
+ */
+ virtual double getLongitude_deg () const { return _lon_deg; }
+
+ /**
+ * Get the latitude in degrees.
+ */
+ virtual double getLatitude_deg () const { return _lat_deg; }
+
+ /**
+ * Get the altitude in feet ASL.
+ */
+ virtual double getAltitudeASL_ft () const { return _alt_ft; }
+
+ /**
+ * Get the absolute view position in fgfs coordinates.
+ */
+ virtual const double * getAbsoluteViewPos () const;
+
+
+ /**
+ * Get the relative view position in fgfs coordinates.
+ *
+ * The position is relative to the scenery centre.
+ */
+ virtual const float * getRelativeViewPos () const;
+
+
+ /**
+ * Get the absolute zero-elevation view position in fgfs coordinates.
+ */
+ virtual const float * getZeroElevViewPos () const;
+
+private:
+
+ void recalc () const;
+
+ mutable sgdVec3 _absolute_view_pos;
+ mutable sgVec3 _relative_view_pos;
+ mutable sgVec3 _zero_elev_view_pos;
+
+ bool _dirty;
+ double _lon_deg;
+ double _lat_deg;
+ double _alt_ft;
+
+};
+
+
// Define a structure containing view information
class FGViewer {
FG_HPR = 2
};
+ 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
+ };
+
private:
// flag forcing a recalc of derived view parameters
protected:
fgViewType _type;
+ fgScalingType scalingType;
+
+ FGViewPoint view_point;
- // the field of view in the x (width) direction
+ // the nominal field of view (angle, in degrees)
double fov;
- // ratio of x and y fov's; fov(y) = fov(x) * win_ratio
- double win_ratio;
+ // ratio of window width and height; height = width * aspect_ratio
+ double aspect_ratio;
// the current view offset angle from forward (rotated about the
// view_up vector)
double view_offset;
+ bool reverse_view_offset;
// the goal view offset angle (used for smooth view changes)
double goal_view_offset;
+ // the view tilt angles
+ double view_tilt;
+ double goal_view_tilt;
+
// geodetic view position
sgdVec3 geod_view_pos;
// translated to scenery.center
sgVec3 zero_elev;
+ // height ASL of the terrain for our current view position
+ // (future?) double ground_elev;
+
// 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.
inline void set_clean() { dirty = false; }
// Update the view volume, position, and orientation
- virtual void update();
+ virtual void update() = 0;
public:
// Destructor
virtual ~FGViewer( void );
+ virtual void init ();
+ virtual void bind ();
+ virtual void unbind ();
+ virtual void update (int dt);
+
//////////////////////////////////////////////////////////////////////
// setter functions
//////////////////////////////////////////////////////////////////////
- inline void set_fov( double amount ) { fov = amount; }
- inline void set_win_ratio( double r ) { win_ratio = r; }
+
+ inline void set_fov( double fov_deg ) {
+ fov = fov_deg;
+ }
+
+ inline void set_aspect_ratio( double r ) {
+ aspect_ratio = r;
+ }
inline void set_view_offset( double a ) {
set_dirty();
view_offset = a;
inline void set_goal_view_offset( double a) {
set_dirty();
goal_view_offset = a;
+ while ( goal_view_offset < 0.0 ) {
+ goal_view_offset += SGD_2PI;
+ }
+ while ( goal_view_offset > SGD_2PI ) {
+ goal_view_offset -= SGD_2PI;
+ }
+ }
+ inline void set_reverse_view_offset( bool val ) {
+ reverse_view_offset = val;
+ }
+ inline void set_view_tilt( double a ) {
+ set_dirty();
+ view_tilt = a;
+ }
+ inline void inc_view_tilt( double amt ) {
+ set_dirty();
+ view_tilt += amt;
+ }
+ inline void set_goal_view_tilt( double a) {
+ set_dirty();
+ goal_view_tilt = a;
+ while ( goal_view_tilt < 0 ) {
+ goal_view_tilt += 360.0;
+ }
+ while ( goal_view_tilt > 360.0 ) {
+ goal_view_tilt -= 360.0;
+ }
}
inline void set_geod_view_pos( double lon, double lat, double alt ) {
// data should be in radians and meters asl
inline int is_a( int t ) const { return get_type() == t ; }
inline bool is_dirty() const { return dirty; }
inline double get_fov() const { return fov; }
- inline double get_win_ratio() const { return win_ratio; }
+ inline double get_aspect_ratio() const { return aspect_ratio; }
inline double get_view_offset() const { return view_offset; }
+ inline bool get_reverse_view_offset() const { return reverse_view_offset; }
inline double get_goal_view_offset() const { return goal_view_offset; }
+ inline double get_view_tilt() const { return view_tilt; }
+ inline double get_goal_view_tilt() const { return goal_view_tilt; }
inline double *get_geod_view_pos() { return geod_view_pos; }
inline float *get_pilot_offset() { return pilot_offset; }
inline double get_sea_level_radius() const { return sea_level_radius; }
+ // Get horizontal field of view angle, in degrees.
+ double get_h_fov();
+ // Get vertical field of view angle, in degrees.
+ double get_v_fov();
//////////////////////////////////////////////////////////////////////
// derived values accessor functions
if ( dirty ) { update(); }
return zero_elev;
}
+ // (future?)
+ // inline double get_ground_elev() {
+ // if ( dirty ) { update(); }
+ // return ground_elev;
+ // }
inline float *get_surface_south() {
if ( dirty ) { update(); }
return surface_south;