Math/polar3d.hxx

   1 // polar.hxx -- routines to deal with polar math and transformations
   2 //
   3 // Written by Curtis Olson, started June 1997.
   4 //
   5 // Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
   6 //
   7 // This program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 //
  21 // $Id$
  22 // (Log is kept at end of this file)
  23
  24
  25 #ifndef _POLAR_HXX
  26 #define _POLAR_HXX
  27
  28
  29 #ifndef __cplusplus
  30 # error This library requires C++
  31 #endif
  32
  33
  34 #include <Include/fg_constants.h>
  35 #include <Math/point3d.hxx>
  36
  37
  38 // Convert a polar coordinate to a cartesian coordinate.  Lon and Lat
  39 // must be specified in radians.  The FG convention is for distances
  40 // to be specified in meters
  41 Point3D fgPolarToCart3d(const Point3D& p);
  42
  43
  44 // Convert a cartesian coordinate to polar coordinates (lon/lat
  45 // specified in radians.  Distances are specified in meters.
  46 Point3D fgCartToPolar3d(const Point3D& cp);
  47
  48
  49 // Find the Altitude above the Ellipsoid (WGS84) given the Earth
  50 // Centered Cartesian coordinate vector Distances are specified in
  51 // meters.
  52 double fgGeodAltFromCart(const Point3D& cp);
  53
  54
  55 #endif // _POLAR_HXX
  56
  57
  58 // $Log$
  59 // Revision 1.4  1998/10/16 19:30:07  curt
  60 // C++-ified the comments.
  61 //
  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