Main/views.hxx

   1 //
   2 // views.hxx -- data structures and routines for managing and view parameters.
   3 //
   4 // Written by Curtis Olson, started August 1997.
   5 //
   6 // Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
   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., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 //
  22 // $Id$
  23 // (Log is kept at end of this file)
  24
  25
  26 #ifndef _VIEWS_HXX
  27 #define _VIEWS_HXX
  28
  29
  30 #ifndef __cplusplus
  31 # error This library requires C++
  32 #endif
  33
  34
  35 #include <Include/fg_types.h>
  36 #include <Flight/flight.h>
  37 #include <Math/mat3.h>
  38 #include <Time/fg_time.hxx>
  39 #include <Time/light.hxx>
  40
  41
  42 // Define a structure containing view information
  43 class fgVIEW {
  44
  45 public:
  46
  47     // the current offset from forward for viewing
  48     double view_offset;
  49
  50     // the goal view offset for viewing (used for smooth view changes)
  51     double goal_view_offset;
  52
  53     // fov of view is specified in the y direction, win_ratio is used to
  54     // calculate the fov in the X direction = width/height
  55     double win_ratio;
  56
  57     // width & height of window
  58     int winWidth, winHeight;
  59
  60     // sin and cos of (fov / 2) in Y axis
  61     double sin_fov_y, cos_fov_y;
  62
  63     // slope of view frustum edge in eye space Y axis
  64     double slope_y;
  65
  66     // sin and cos of (fov / 2) in X axis
  67     double sin_fov_x, cos_fov_x;
  68
  69     // slope of view frustum edge in eye space X axis
  70     double slope_x;
  71
  72     // absolute view position
  73     fgCartesianPoint3d abs_view_pos;
  74
  75     // view position translated to scenery.center
  76     fgCartesianPoint3d view_pos;
  77
  78     // cartesion coordinates of current lon/lat if at sea level
  79     // translated to scenery.center*/
  80     fgCartesianPoint3d cur_zero_elev;
  81
  82     // vector in cartesian coordinates from current position to the
  83     // postion on the earth's surface the sun is directly over
  84     MAT3vec to_sun;
  85
  86     // surface direction to go to head towards sun
  87     MAT3vec surface_to_sun;
  88
  89     // surface vector heading south
  90     MAT3vec surface_south;
  91
  92     // surface vector heading east (used to unambiguously align sky
  93     // with sun)
  94     MAT3vec surface_east;
  95
  96     // local up vector (normal to the plane tangent to the earth's
  97     // surface at the spot we are directly above
  98     MAT3vec local_up;
  99
 100     // up vector for the view (usually point straight up through the
 101     // top of the aircraft
 102     MAT3vec view_up;
 103
 104     // the vector pointing straight out the nose of the aircraft
 105     MAT3vec view_forward;
 106
 107     // Transformation matrix for eye coordinates to aircraft coordinates
 108     MAT3mat AIRCRAFT;
 109
 110     // Transformation matrix for aircraft coordinates to world
 111     // coordinates
 112     MAT3mat WORLD;
 113
 114     // Combined transformation from eye coordinates to world coordinates
 115     MAT3mat EYE_TO_WORLD;
 116
 117     // Inverse of EYE_TO_WORLD which is a transformation from world
 118     // coordinates to eye coordinates
 119     MAT3mat WORLD_TO_EYE;
 120
 121     // Constructor
 122     fgVIEW( void );
 123
 124     // Initialize a view class
 125     void Init( void );
 126
 127     // Update the view parameters
 128     void Update( fgFLIGHT *f );
 129
 130     // Update the "World to Eye" transformation matrix
 131     void UpdateWorldToEye(  fgFLIGHT *f );
 132
 133     // Destructor
 134     ~fgVIEW( void );
 135 };
 136
 137
 138 extern fgVIEW current_view;
 139
 140
 141 #endif // _VIEWS_HXX
 142
 143
 144 // $Log$
 145 // Revision 1.6  1998/05/16 13:08:37  curt
 146 // C++ - ified views.[ch]xx
 147 // Shuffled some additional view parameters into the fgVIEW class.
 148 // Changed tile-radius to tile-diameter because it is a much better
 149 //   name.
 150 // Added a WORLD_TO_EYE transformation to views.cxx.  This allows us
 151 //  to transform world space to eye space for view frustum culling.
 152 //
 153 // Revision 1.5  1998/05/02 01:51:02  curt
 154 // Updated polartocart conversion routine.
 155 //
 156 // Revision 1.4  1998/04/28 01:20:24  curt
 157 // Type-ified fgTIME and fgVIEW.
 158 // Added a command line option to disable textures.
 159 //
 160 // Revision 1.3  1998/04/25 22:06:31  curt
 161 // Edited cvs log messages in source files ... bad bad bad!
 162 //
 163 // Revision 1.2  1998/04/24 00:49:22  curt
 164 // Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
 165 // Trying out some different option parsing code.
 166 // Some code reorganization.
 167 //
 168 // Revision 1.1  1998/04/22 13:25:46  curt
 169 // C++ - ifing the code.
 170 // Starting a bit of reorganization of lighting code.
 171 //
 172 // Revision 1.11  1998/04/21 17:02:42  curt
 173 // Prepairing for C++ integration.
 174 //
 175 // Revision 1.10  1998/02/07 15:29:45  curt
 176 // Incorporated HUD changes and struct/typedef changes from Charlie Hotchkiss
 177 // <chotchkiss@namg.us.anritsu.com>
 178 //
 179 // Revision 1.9  1998/01/29 00:50:29  curt
 180 // Added a view record field for absolute x, y, z position.
 181 //
 182 // Revision 1.8  1998/01/27 00:47:58  curt
 183 // Incorporated Paul Bleisch's <pbleisch@acm.org> new debug message
 184 // system and commandline/config file processing code.
 185 //
 186 // Revision 1.7  1998/01/22 02:59:38  curt
 187 // Changed #ifdef FILE_H to #ifdef _FILE_H
 188 //
 189 // Revision 1.6  1998/01/19 19:27:10  curt
 190 // Merged in make system changes from Bob Kuehne <rpk@sgi.com>
 191 // This should simplify things tremendously.
 192 //
 193 // Revision 1.5  1997/12/22 04:14:32  curt
 194 // Aligned sky with sun so dusk/dawn effects can be correct relative to the sun.
 195 //
 196 // Revision 1.4  1997/12/17 23:13:36  curt
 197 // Began working on rendering a sky.
 198 //
 199 // Revision 1.3  1997/12/15 23:54:51  curt
 200 // Add xgl wrappers for debugging.
 201 // Generate terrain normals on the fly.
 202 //
 203 // Revision 1.2  1997/12/10 22:37:48  curt
 204 // Prepended "fg" on the name of all global structures that didn't have it yet.
 205 // i.e. "struct WEATHER {}" became "struct fgWEATHER {}"
 206 //
 207 // Revision 1.1  1997/08/27 21:31:18  curt
 208 // Initial revision.
 209 //