Math/polar3d.hxx

   1 /**************************************************************************
   2  * polar.hxx -- 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_HXX
  28 #define _POLAR_HXX
  29
  30
  31 #ifndef __cplusplus
  32 # error This library requires C++
  33 #endif
  34
  35
  36 #include <Include/fg_constants.h>
  37 // #include <Include/fg_types.h>
  38 #include <Math/point3d.hxx>
  39
  40
  41 /* Convert a polar coordinate to a cartesian coordinate.  Lon and Lat
  42  * must be specified in radians.  The FG convention is for distances
  43  * to be specified in meters */
  44 Point3D fgPolarToCart3d(const Point3D& p);
  45
  46
  47 /* Convert a cartesian coordinate to polar coordinates (lon/lat
  48  * specified in radians.  Distances are specified in meters. */
  49 Point3D fgCartToPolar3d(const Point3D& cp);
  50
  51
  52 /* Find the Altitude above the Ellipsoid (WGS84) given the Earth
  53  * Centered Cartesian coordinate vector Distances are specified in
  54  * meters. */
  55 double fgGeodAltFromCart(const Point3D& cp);
  56
  57
  58 #endif /* _POLAR_HXX */
  59
  60
  61 /* $Log$
  62 /* Revision 1.3  1998/10/16 00:50:30  curt
  63 /* Added point3d.hxx to replace cheezy fgPoint3d struct.
  64 /*
  65  * Revision 1.2  1998/08/24 20:04:12  curt
  66  * Various "inline" code optimizations contributed by Norman Vine.
  67  *
  68  * Revision 1.1  1998/07/08 14:40:09  curt
  69  * polar3d.[ch] renamed to polar3d.[ch]xx, vector.[ch] renamed to vector.[ch]xx
  70  * Updated fg_geodesy comments to reflect that routines expect and produce
  71  *   meters.
  72  *
  73  * Revision 1.1  1998/05/02 01:50:11  curt
  74  * polar.[ch] renamed to polar3d.[ch]
  75  *
  76  * Revision 1.9  1998/04/25 22:06:23  curt
  77  * Edited cvs log messages in source files ... bad bad bad!
  78  *
  79  * Revision 1.8  1998/04/21 17:03:50  curt
  80  * Prepairing for C++ integration.
  81  *
  82  * Revision 1.7  1998/01/27 00:48:00  curt
  83  * Incorporated Paul Bleisch's <pbleisch@acm.org> new debug message
  84  * system and commandline/config file processing code.
  85  *
  86  * Revision 1.6  1998/01/22 02:59:39  curt
  87  * Changed #ifdef FILE_H to #ifdef _FILE_H
  88  *
  89  * Revision 1.5  1998/01/19 19:27:13  curt
  90  * Merged in make system changes from Bob Kuehne <rpk@sgi.com>
  91  * This should simplify things tremendously.
  92  *
  93  * Revision 1.4  1997/12/15 23:54:55  curt
  94  * Add xgl wrappers for debugging.
  95  * Generate terrain normals on the fly.
  96  *
  97  * Revision 1.3  1997/07/31 22:52:28  curt
  98  * Working on redoing internal coordinate systems & scenery transformations.
  99  *
 100  * Revision 1.2  1997/07/23 21:52:21  curt
 101  * Put comments around the text after an #endif for increased portability.
 102  *
 103  * Revision 1.1  1997/07/07 21:02:37  curt
 104  * Initial revision.
 105  *
 106  */