PierMesh
/
direwolf
mirror of https://github.com/wb2osz/direwolf.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
direwolf/external/geotranz/tranmerc.h

210 lines
8.6 KiB
C
Raw Normal View History

Version 1.2 new file: A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf new file: A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf modified: APRStt-Implementation-Notes.pdf modified: CHANGES.txt new file: Makefile modified: Makefile.linux modified: Makefile.win deleted: Quick-Start-Guide-Windows.pdf modified: Raspberry-Pi-APRS-Tracker.pdf modified: Raspberry-Pi-APRS.pdf modified: User-Guide.pdf modified: aclients.c modified: aprs_tt.c modified: aprs_tt.h modified: atest.c modified: audio.c modified: audio.h modified: audio_win.c modified: ax25_pad.c modified: ax25_pad.h modified: beacon.c modified: beacon.h modified: config.c modified: config.h modified: decode_aprs.c modified: decode_aprs.h modified: demod.c modified: demod.h modified: demod_9600.c modified: demod_9600.h modified: demod_afsk.c modified: digipeater.c modified: digipeater.h modified: direwolf.c modified: direwolf.conf deleted: direwolf.desktop modified: direwolf.h new file: direwolf.spec new file: direwolf.txt new file: dlq.c new file: dlq.h modified: dsp.c new file: dtime_now.c new file: dtime_now.h modified: dtmf.c modified: dtmf.h new file: dwespeak.bat new file: dwespeak.sh modified: fsk_demod_state.h modified: gen_packets.c modified: gen_tone.c new file: geotranz/README-FIRST.txt new file: geotranz/error_string.c new file: geotranz/error_string.h new file: geotranz/mgrs.c new file: geotranz/mgrs.h new file: geotranz/polarst.c new file: geotranz/polarst.h new file: geotranz/readme.txt new file: geotranz/releasenotes.txt new file: geotranz/tranmerc.c new file: geotranz/tranmerc.h new file: geotranz/ups.c new file: geotranz/ups.h new file: geotranz/usng.c new file: geotranz/usng.h new file: geotranz/utm.c new file: geotranz/utm.h modified: hdlc_rec.c modified: hdlc_rec.h modified: hdlc_rec2.c modified: hdlc_rec2.h modified: hdlc_send.c modified: igate.c modified: igate.h modified: kiss_frame.c modified: kiss_frame.h modified: kissnet.c modified: latlong.c modified: latlong.h modified: ll2utm.c modified: log.c modified: log.h new file: man1/aclients.1 new file: man1/atest.1 new file: man1/decode_aprs.1 new file: man1/direwolf.1 new file: man1/gen_packets.1 new file: man1/ll2utm.1 new file: man1/log2gpx.1 new file: man1/text2tt.1 new file: man1/tt2text.1 new file: man1/utm2ll.1 modified: multi_modem.c modified: multi_modem.h new file: pfilter.c new file: pfilter.h modified: ptt.c modified: ptt.h deleted: pttest.c modified: rdq.c new file: recv.c new file: recv.h modified: redecode.c modified: redecode.h modified: rrbb.c modified: rrbb.h modified: server.c modified: server.h modified: telemetry.c modified: telemetry.h modified: textcolor.c modified: textcolor.h modified: tocalls.txt modified: tq.c modified: tq.h modified: tt_text.c modified: tt_text.h modified: tt_user.c modified: tt_user.h new file: ttcalc.c deleted: udp_test.c deleted: utm/LatLong-UTMconversion.c deleted: utm/LatLong-UTMconversion.h deleted: utm/README.txt deleted: utm/SwissGrid.cpp deleted: utm/UTMConversions.cpp deleted: utm/constants.h modified: utm2ll.c modified: version.h new file: xid.c modified: xmit.c modified: xmit.h
2015-07-27 01:17:23 +00:00
#ifndef TRANMERC_H
#define TRANMERC_H
/***************************************************************************/
/* RSC IDENTIFIER: TRANSVERSE MERCATOR
*
* ABSTRACT
*
* This component provides conversions between Geodetic coordinates
* (latitude and longitude) and Transverse Mercator projection coordinates
* (easting and northing).
*
* ERROR HANDLING
*
* This component checks parameters for valid values. If an invalid value
* is found the error code is combined with the current error code using
* the bitwise or. This combining allows multiple error codes to be
* returned. The possible error codes are:
*
* TRANMERC_NO_ERROR : No errors occurred in function
* TRANMERC_LAT_ERROR : Latitude outside of valid range
* (-90 to 90 degrees)
* TRANMERC_LON_ERROR : Longitude outside of valid range
* (-180 to 360 degrees, and within
* +/-90 of Central Meridian)
* TRANMERC_EASTING_ERROR : Easting outside of valid range
* (depending on ellipsoid and
* projection parameters)
* TRANMERC_NORTHING_ERROR : Northing outside of valid range
* (depending on ellipsoid and
* projection parameters)
* TRANMERC_ORIGIN_LAT_ERROR : Origin latitude outside of valid range
* (-90 to 90 degrees)
* TRANMERC_CENT_MER_ERROR : Central meridian outside of valid range
* (-180 to 360 degrees)
* TRANMERC_A_ERROR : Semi-major axis less than or equal to zero
* TRANMERC_INV_F_ERROR : Inverse flattening outside of valid range
* (250 to 350)
* TRANMERC_SCALE_FACTOR_ERROR : Scale factor outside of valid
* range (0.3 to 3.0)
* TM_LON_WARNING : Distortion will result if longitude is more
* than 9 degrees from the Central Meridian
*
* REUSE NOTES
*
* TRANSVERSE MERCATOR is intended for reuse by any application that
* performs a Transverse Mercator projection or its inverse.
*
* REFERENCES
*
* Further information on TRANSVERSE MERCATOR can be found in the
* Reuse Manual.
*
* TRANSVERSE MERCATOR originated from :
* U.S. Army Topographic Engineering Center
* Geospatial Information Division
* 7701 Telegraph Road
* Alexandria, VA 22310-3864
*
* LICENSES
*
* None apply to this component.
*
* RESTRICTIONS
*
* TRANSVERSE MERCATOR has no restrictions.
*
* ENVIRONMENT
*
* TRANSVERSE MERCATOR was tested and certified in the following
* environments:
*
* 1. Solaris 2.5 with GCC, version 2.8.1
* 2. Windows 95 with MS Visual C++, version 6
*
* MODIFICATIONS
*
* Date Description
* ---- -----------
* 10-02-97 Original Code
* 03-02-97 Re-engineered Code
*
*/
/***************************************************************************/
/*
* DEFINES
*/
#define TRANMERC_NO_ERROR 0x0000
#define TRANMERC_LAT_ERROR 0x0001
#define TRANMERC_LON_ERROR 0x0002
#define TRANMERC_EASTING_ERROR 0x0004
#define TRANMERC_NORTHING_ERROR 0x0008
#define TRANMERC_ORIGIN_LAT_ERROR 0x0010
#define TRANMERC_CENT_MER_ERROR 0x0020
#define TRANMERC_A_ERROR 0x0040
#define TRANMERC_INV_F_ERROR 0x0080
#define TRANMERC_SCALE_FACTOR_ERROR 0x0100
#define TRANMERC_LON_WARNING 0x0200
/***************************************************************************/
/*
* FUNCTION PROTOTYPES
* for TRANMERC.C
*/
/* ensure proper linkage to c++ programs */
#ifdef __cplusplus
extern "C" {
#endif
long Set_Transverse_Mercator_Parameters(double a,
double f,
double Origin_Latitude,
double Central_Meridian,
double False_Easting,
double False_Northing,
double Scale_Factor);
/*
* The function Set_Tranverse_Mercator_Parameters receives the ellipsoid
* parameters and Tranverse Mercator projection parameters as inputs, and
* sets the corresponding state variables. If any errors occur, the error
* code(s) are returned by the function, otherwise TRANMERC_NO_ERROR is
* returned.
*
* a : Semi-major axis of ellipsoid, in meters (input)
* f : Flattening of ellipsoid (input)
* Origin_Latitude : Latitude in radians at the origin of the (input)
* projection
* Central_Meridian : Longitude in radians at the center of the (input)
* projection
* False_Easting : Easting/X at the center of the projection (input)
* False_Northing : Northing/Y at the center of the projection (input)
* Scale_Factor : Projection scale factor (input)
*/
void Get_Transverse_Mercator_Parameters(double *a,
double *f,
double *Origin_Latitude,
double *Central_Meridian,
double *False_Easting,
double *False_Northing,
double *Scale_Factor);
/*
* The function Get_Transverse_Mercator_Parameters returns the current
* ellipsoid and Transverse Mercator projection parameters.
*
* a : Semi-major axis of ellipsoid, in meters (output)
* f : Flattening of ellipsoid (output)
* Origin_Latitude : Latitude in radians at the origin of the (output)
* projection
* Central_Meridian : Longitude in radians at the center of the (output)
* projection
* False_Easting : Easting/X at the center of the projection (output)
* False_Northing : Northing/Y at the center of the projection (output)
* Scale_Factor : Projection scale factor (output)
*/
long Convert_Geodetic_To_Transverse_Mercator (double Latitude,
double Longitude,
double *Easting,
double *Northing);
/*
* The function Convert_Geodetic_To_Transverse_Mercator converts geodetic
* (latitude and longitude) coordinates to Transverse Mercator projection
* (easting and northing) coordinates, according to the current ellipsoid
* and Transverse Mercator projection coordinates. If any errors occur, the
* error code(s) are returned by the function, otherwise TRANMERC_NO_ERROR is
* returned.
*
* Latitude : Latitude in radians (input)
* Longitude : Longitude in radians (input)
* Easting : Easting/X in meters (output)
* Northing : Northing/Y in meters (output)
*/
long Convert_Transverse_Mercator_To_Geodetic (double Easting,
double Northing,
double *Latitude,
double *Longitude);
/*
* The function Convert_Transverse_Mercator_To_Geodetic converts Transverse
* Mercator projection (easting and northing) coordinates to geodetic
* (latitude and longitude) coordinates, according to the current ellipsoid
* and Transverse Mercator projection parameters. If any errors occur, the
* error code(s) are returned by the function, otherwise TRANMERC_NO_ERROR is
* returned.
*
* Easting : Easting/X in meters (input)
* Northing : Northing/Y in meters (input)
* Latitude : Latitude in radians (output)
* Longitude : Longitude in radians (output)
*/
#ifdef __cplusplus
}
#endif
#endif /* TRANMERC_H */