Math/polar.h

   1 /**************************************************************************
   2  * polar.h -- routines to deal with polar math and transformations
   3  *
   4  * Written by Curtis Olson, started June 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 _POLAR_H
  28 #define _POLAR_H
  29
  30
  31 #include <Include/fg_types.h>
  32
  33
  34 /* Convert a polar coordinate to a cartesian coordinate.  Lon and Lat
  35  * must be specified in radians.  The FG convention is for distances
  36  * to be specified in meters */
  37 struct fgCartesianPoint fgPolarToCart(double lon, double lat, double radius);
  38
  39
  40 /* Precalculate as much as possible so we can do a batch of transforms
  41  * through the same angles, will rotates a cartesian point about the
  42  * center of the earth by Theta (longitude axis) and Phi (latitude
  43  * axis) */
  44
  45 /* Here are the unoptimized transformation equations
  46
  47    x' = cos(Phi) * cos(Theta) * x + cos(Phi) * sin(Theta) * y +
  48              sin(Phi) * z
  49    y' = -sin(Theta) * x + cos(Theta) * y
  50    z' = -sin(Phi) * sin(Theta) * y - sin(Phi) * cos(Theta) * x +
  51              cos(Phi) * z;
  52
  53  */
  54 void fgRotateBatchInit(double Theta, double Phi);
  55
  56
  57 /* Rotates a cartesian point about the center of the earth by Theta
  58  * (longitude axis) and Phi (latitude axis) */
  59 struct fgCartesianPoint fgRotateCartesianPoint(struct fgCartesianPoint p);
  60
  61
  62 #endif /* _POLAR_H */
  63
  64
  65 /* $Log$
  66 /* Revision 1.7  1998/01/27 00:48:00  curt
  67 /* Incorporated Paul Bleisch's <bleisch@chromatic.com> new debug message
  68 /* system and commandline/config file processing code.
  69 /*
  70  * Revision 1.6  1998/01/22 02:59:39  curt
  71  * Changed #ifdef FILE_H to #ifdef _FILE_H
  72  *
  73  * Revision 1.5  1998/01/19 19:27:13  curt
  74  * Merged in make system changes from Bob Kuehne <rpk@sgi.com>
  75  * This should simplify things tremendously.
  76  *
  77  * Revision 1.4  1997/12/15 23:54:55  curt
  78  * Add xgl wrappers for debugging.
  79  * Generate terrain normals on the fly.
  80  *
  81  * Revision 1.3  1997/07/31 22:52:28  curt
  82  * Working on redoing internal coordinate systems & scenery transformations.
  83  *
  84  * Revision 1.2  1997/07/23 21:52:21  curt
  85  * Put comments around the text after an #endif for increased portability.
  86  *
  87  * Revision 1.1  1997/07/07 21:02:37  curt
  88  * Initial revision.
  89  *
  90  */