Main/views.h

   1 /**************************************************************************
   2  * views.h -- 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_H
  28 #define VIEWS_H
  29
  30
  31 #include <Include/types.h>
  32 #include <Flight/flight.h>
  33 #include <Math/mat3.h>
  34 #include <Time/fg_time.h>
  35
  36
  37 /* Define a structure containing view information */
  38 struct fgVIEW {
  39     /* view position translated to scenery.center */
  40     struct fgCartesianPoint view_pos;
  41
  42     /* cartesion coordinates of current lon/lat if at sea level
  43      * translated to scenery.center*/
  44     struct fgCartesianPoint cur_zero_elev;
  45
  46     /* vector in cartesian coordinates from current position to the
  47      * postion on the earth's surface the sun is directly over */
  48     MAT3vec to_sun;
  49
  50     /* surface direction to go to head towards sun */
  51     MAT3vec surface_to_sun;
  52
  53     /* surface vector heading south */
  54     MAT3vec surface_south;
  55
  56     /* surface vector heading east (used to unambiguously align sky with sun) */
  57     MAT3vec surface_east;
  58
  59     /* local up vector (normal to the plane tangent to the earth's
  60      * surface at the spot we are directly above */
  61     MAT3vec local_up;
  62
  63     /* up vector for the view (usually point straight up through the
  64      * top of the aircraft */
  65     MAT3vec view_up;
  66
  67     /* the vector pointing straight out the nose of the aircraft */
  68     MAT3vec view_forward;
  69
  70     /* the current offset from forward for viewing */
  71     double view_offset;
  72
  73     /* the goal view offset for viewing (used for smooth view changes) */
  74     double goal_view_offset;
  75 };
  76
  77
  78 extern struct fgVIEW current_view;
  79
  80
  81 /* Initialize a view structure */
  82 void fgViewInit(struct fgVIEW *v);
  83
  84 /* Update the view parameters */
  85 void fgViewUpdate(struct fgFLIGHT *f, struct fgVIEW *v, struct fgLIGHT *l);
  86
  87
  88 #endif /* VIEWS_H */
  89
  90
  91 /* $Log$
  92 /* Revision 1.6  1998/01/19 19:27:10  curt
  93 /* Merged in make system changes from Bob Kuehne <rpk@sgi.com>
  94 /* This should simplify things tremendously.
  95 /*
  96  * Revision 1.5  1997/12/22 04:14:32  curt
  97  * Aligned sky with sun so dusk/dawn effects can be correct relative to the sun.
  98  *
  99  * Revision 1.4  1997/12/17 23:13:36  curt
 100  * Began working on rendering a sky.
 101  *
 102  * Revision 1.3  1997/12/15 23:54:51  curt
 103  * Add xgl wrappers for debugging.
 104  * Generate terrain normals on the fly.
 105  *
 106  * Revision 1.2  1997/12/10 22:37:48  curt
 107  * Prepended "fg" on the name of all global structures that didn't have it yet.
 108  * i.e. "struct WEATHER {}" became "struct fgWEATHER {}"
 109  *
 110  * Revision 1.1  1997/08/27 21:31:18  curt
 111  * Initial revision.
 112  *
 113  */