From 9725b4439dcce40fc464fd7062cb31b3fba94513 Mon Sep 17 00:00:00 2001 From: Frank Warmerdam Date: Sun, 23 Jun 2013 04:12:26 +0000 Subject: sync up with what will be GeographicLib 1.31 (#216) git-svn-id: http://svn.osgeo.org/metacrs/proj/trunk@2353 4e78687f-474d-0410-85f9-8d5e500ac6b2 --- src/geodesic.h | 41 +++++++++++++++++++++-------------------- 1 file changed, 21 insertions(+), 20 deletions(-) (limited to 'src/geodesic.h') diff --git a/src/geodesic.h b/src/geodesic.h index 2c49d0dc..87d087a5 100644 --- a/src/geodesic.h +++ b/src/geodesic.h @@ -116,7 +116,7 @@ * http://geographiclib.sourceforge.net/ * * This library was distributed with - * GeographicLib 1.30. + * GeographicLib 1.31. **********************************************************************/ #if !defined(GEODESIC_H) @@ -127,7 +127,8 @@ extern "C" { #endif /** - * The struct containing information about the ellipsoid. + * The struct containing information about the ellipsoid. This must be + * initialized by geod_init() before use. **********************************************************************/ struct geod_geodesic { double a; /**< the equatorial radius */ @@ -139,7 +140,8 @@ extern "C" { }; /** - * The struct containing information about a single geodesic. + * The struct containing information about a single geodesic. This must be + * initialized by geod_lineinit() before use. **********************************************************************/ struct geod_geodesicline { double lat1; /**< the starting latitude */ @@ -182,17 +184,17 @@ extern "C" { * should be in the range [−90°, 90°]; \e azi1 should be in the * range [−540°, 540°). * - * The geod_mask values are + * The geod_mask values are [see geod_mask()]: * - \e caps |= GEOD_LATITUDE for the latitude \e lat2; this is - * added automatically - * - \e caps |= GEOD_LONGITUDE for the latitude \e lon2 + * added automatically, + * - \e caps |= GEOD_LONGITUDE for the latitude \e lon2, * - \e caps |= GEOD_AZIMUTH for the latitude \e azi2; this is - * added automatically - * - \e caps |= GEOD_DISTANCE for the distance \e s12 - * - \e caps |= GEOD_REDUCEDLENGTH for the reduced length \e m12 + * added automatically, + * - \e caps |= GEOD_DISTANCE for the distance \e s12, + * - \e caps |= GEOD_REDUCEDLENGTH for the reduced length \e m12, * - \e caps |= GEOD_GEODESICSCALE for the geodesic scales \e M12 - * and \e M21 - * - \e caps |= GEOD_AREA for the area \e S12 + * and \e M21, + * - \e caps |= GEOD_AREA for the area \e S12, * - \e caps |= GEOD_DISTANCE_IN permits the length of the * geodesic to be given in terms of \e s12; without this capability the * length can only be specified in terms of arc length. @@ -226,11 +228,11 @@ extern "C" { * need some quantities computed. * * If either point is at a pole, the azimuth is defined by keeping the - * longitude fixed and writing \e lat = ±(90° − ε) - * and taking the limit ε → 0+. An arc length greater that - * 180° signifies a geodesic which is not a shortest path. (For a - * prolate ellipsoid, an additional condition is necessary for a shortest - * path: the longitudinal extent must not exceed of 180°.) + * longitude fixed, writing \e lat = ±(90° − ε), and + * taking the limit ε → 0+. An arc length greater that 180° + * signifies a geodesic which is not a shortest path. (For a prolate + * ellipsoid, an additional condition is necessary for a shortest path: the + * longitudinal extent must not exceed of 180°.) * * Example, determine the point 10000 km NE of JFK: @code @@ -266,8 +268,8 @@ extern "C" { * not need some quantities computed. * * If either point is at a pole, the azimuth is defined by keeping the - * longitude fixed and writing \e lat = ±(90° − ε) - * and taking the limit ε → 0+. + * longitude fixed, writing \e lat = ±(90° − ε), and + * taking the limit ε → 0+. * * The solution to the inverse problem is found using Newton's method. If * this fails to converge (this is very unlikely in geodetic applications @@ -436,7 +438,6 @@ extern "C" { * @param[out] pS12 pointer to the area under the geodesic * (meters2); requires that \e l was initialized with \e caps |= * GEOD_AREA. - * @return \e a12 arc length of between point 1 and point 2 (degrees). * * \e l must have been initialized with a call to geod_lineinit() with \e @@ -514,7 +515,7 @@ extern "C" { * mask values for geod_geodesicline capabilities. **********************************************************************/ enum geod_mask { - GEOD_NONE = 0U, + GEOD_NONE = 0U, /**< Calculate nothing */ GEOD_LATITUDE = 1U<<7 | 0U, /**< Calculate latitude */ GEOD_LONGITUDE = 1U<<8 | 1U<<3, /**< Calculate longitude */ GEOD_AZIMUTH = 1U<<9 | 0U, /**< Calculate azimuth */ -- cgit v1.2.3