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
  27 #ifndef _VIEWS_HXX
  28 #define _VIEWS_HXX
  29
  30
  31 #ifndef __cplusplus
  32 # error This library requires C++
  33 #endif
  34
  35
  36 #include <Include/fg_types.h>
  37 #include <Flight/flight.h>
  38 #include <Math/mat3.h>
  39 #include <Time/fg_time.hxx>
  40 #include <Time/light.hxx>
  41
  42
  43 /* Define a structure containing view information */
  44 struct fgVIEW {
  45     /* absolute view position */
  46     struct fgCartesianPoint abs_view_pos;
  47
  48     /* view position translated to scenery.center */
  49     struct fgCartesianPoint view_pos;
  50
  51     /* cartesion coordinates of current lon/lat if at sea level
  52      * translated to scenery.center*/
  53     struct fgCartesianPoint cur_zero_elev;
  54
  55     /* vector in cartesian coordinates from current position to the
  56      * postion on the earth's surface the sun is directly over */
  57     MAT3vec to_sun;
  58
  59     /* surface direction to go to head towards sun */
  60     MAT3vec surface_to_sun;
  61
  62     /* surface vector heading south */
  63     MAT3vec surface_south;
  64
  65     /* surface vector heading east (used to unambiguously align sky with sun) */
  66     MAT3vec surface_east;
  67
  68     /* local up vector (normal to the plane tangent to the earth's
  69      * surface at the spot we are directly above */
  70     MAT3vec local_up;
  71
  72     /* up vector for the view (usually point straight up through the
  73      * top of the aircraft */
  74     MAT3vec view_up;
  75
  76     /* the vector pointing straight out the nose of the aircraft */
  77     MAT3vec view_forward;
  78
  79     /* the current offset from forward for viewing */
  80     double view_offset;
  81
  82     /* the goal view offset for viewing (used for smooth view changes) */
  83     double goal_view_offset;
  84 };
  85
  86
  87 extern struct fgVIEW current_view;
  88
  89
  90 /* Initialize a view structure */
  91 void fgViewInit(struct fgVIEW *v);
  92
  93 /* Update the view parameters */
  94 void fgViewUpdate(fgFLIGHT *f, struct fgVIEW *v, fgLIGHT *l);
  95
  96
  97 #endif /* _VIEWS_HXX */
  98
  99
 100 /* $Log$
 101 /* Revision 1.3  1998/04/25 22:06:31  curt
 102 /* Edited cvs log messages in source files ... bad bad bad!
 103 /*
 104  * Revision 1.2  1998/04/24 00:49:22  curt
 105  * Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
 106  * Trying out some different option parsing code.
 107  * Some code reorganization.
 108  *
 109  * Revision 1.1  1998/04/22 13:25:46  curt
 110  * C++ - ifing the code.
 111  * Starting a bit of reorganization of lighting code.
 112  *
 113  * Revision 1.11  1998/04/21 17:02:42  curt
 114  * Prepairing for C++ integration.
 115  *
 116  * Revision 1.10  1998/02/07 15:29:45  curt
 117  * Incorporated HUD changes and struct/typedef changes from Charlie Hotchkiss
 118  * <chotchkiss@namg.us.anritsu.com>
 119  *
 120  * Revision 1.9  1998/01/29 00:50:29  curt
 121  * Added a view record field for absolute x, y, z position.
 122  *
 123  * Revision 1.8  1998/01/27 00:47:58  curt
 124  * Incorporated Paul Bleisch's <pbleisch@acm.org> new debug message
 125  * system and commandline/config file processing code.
 126  *
 127  * Revision 1.7  1998/01/22 02:59:38  curt
 128  * Changed #ifdef FILE_H to #ifdef _FILE_H
 129  *
 130  * Revision 1.6  1998/01/19 19:27:10  curt
 131  * Merged in make system changes from Bob Kuehne <rpk@sgi.com>
 132  * This should simplify things tremendously.
 133  *
 134  * Revision 1.5  1997/12/22 04:14:32  curt
 135  * Aligned sky with sun so dusk/dawn effects can be correct relative to the sun.
 136  *
 137  * Revision 1.4  1997/12/17 23:13:36  curt
 138  * Began working on rendering a sky.
 139  *
 140  * Revision 1.3  1997/12/15 23:54:51  curt
 141  * Add xgl wrappers for debugging.
 142  * Generate terrain normals on the fly.
 143  *
 144  * Revision 1.2  1997/12/10 22:37:48  curt
 145  * Prepended "fg" on the name of all global structures that didn't have it yet.
 146  * i.e. "struct WEATHER {}" became "struct fgWEATHER {}"
 147  *
 148  * Revision 1.1  1997/08/27 21:31:18  curt
 149  * Initial revision.
 150  *
 151  */