QGIS/external/nmea/gmath.h
2018-06-30 09:24:38 +10:00

110 lines
2.9 KiB
C

/*
* Copyright Tim (xtimor@gmail.com)
*
* NMEA library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>
*/
/*
*
* NMEA library
* URL: http://nmea.sourceforge.net
* Author: Tim (xtimor@gmail.com)
* Licence: http://www.gnu.org/licenses/lgpl.html
* $Id: gmath.h 17 2008-03-11 11:56:11Z xtimor $
*
*/
#ifndef NMEA_GMATH_H
#define NMEA_GMATH_H
#include "info.h"
#define NMEA_PI (3.141592653589793) //!< PI value
#define NMEA_PI180 (NMEA_PI / 180) //!< PI division by 180
#define NMEA_EARTHRADIUS_KM (6378) //!< Earth's mean radius in km
#define NMEA_EARTHRADIUS_M (NMEA_EARTHRADIUS_KM * 1000) //!< Earth's mean radius in m
#define NMEA_EARTH_SEMIMAJORAXIS_M (6378137.0) //!< Earth's semi-major axis in m according WGS84
#define NMEA_EARTH_SEMIMAJORAXIS_KM (NMEA_EARTHMAJORAXIS_KM / 1000) //!< Earth's semi-major axis in km according WGS 84
#define NMEA_EARTH_FLATTENING (1 / 298.257223563) //!< Earth's flattening according WGS 84
#define NMEA_DOP_FACTOR (5) //!< Factor for translating DOP to meters
#ifdef __cplusplus
extern "C"
{
#endif
/*
* degree VS radian
*/
double nmea_degree2radian( double val );
double nmea_radian2degree( double val );
/*
* NDEG (NMEA degree)
*/
double nmea_ndeg2degree( double val );
double nmea_degree2ndeg( double val );
double nmea_ndeg2radian( double val );
double nmea_radian2ndeg( double val );
/*
* DOP
*/
double nmea_calc_pdop( double hdop, double vdop );
double nmea_dop2meters( double dop );
double nmea_meters2dop( double meters );
/*
* positions work
*/
void nmea_info2pos( const nmeaINFO *info, nmeaPOS *pos );
void nmea_pos2info( const nmeaPOS *pos, nmeaINFO *info );
double nmea_distance(
const nmeaPOS *from_pos,
const nmeaPOS *to_pos
);
double nmea_distance_ellipsoid(
const nmeaPOS *from_pos,
const nmeaPOS *to_pos,
double *from_azimuth,
double *to_azimuth
);
int nmea_move_horz(
const nmeaPOS *start_pos,
nmeaPOS *end_pos,
double azimuth,
double distance
);
int nmea_move_horz_ellipsoid(
const nmeaPOS *start_pos,
nmeaPOS *end_pos,
double azimuth,
double distance,
double *end_azimuth
);
#ifdef __cplusplus
}
#endif
#endif /* NMEA_GMATH_H */