mirror of
https://agent.ghink.cloud/wb2osz/direwolf
synced 2025-04-06 12:48:31 +00:00
8b81a3226f
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
179 lines
6.7 KiB
C
179 lines
6.7 KiB
C
#ifndef UTM_H
|
|
#define UTM_H
|
|
|
|
/***************************************************************************/
|
|
/* RSC IDENTIFIER: UTM
|
|
*
|
|
* ABSTRACT
|
|
*
|
|
* This component provides conversions between geodetic coordinates
|
|
* (latitude and longitudes) and Universal Transverse Mercator (UTM)
|
|
* projection (zone, hemisphere, easting, and northing) coordinates.
|
|
*
|
|
* 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:
|
|
*
|
|
* UTM_NO_ERROR : No errors occurred in function
|
|
* UTM_LAT_ERROR : Latitude outside of valid range
|
|
* (-80.5 to 84.5 degrees)
|
|
* UTM_LON_ERROR : Longitude outside of valid range
|
|
* (-180 to 360 degrees)
|
|
* UTM_EASTING_ERROR : Easting outside of valid range
|
|
* (100,000 to 900,000 meters)
|
|
* UTM_NORTHING_ERROR : Northing outside of valid range
|
|
* (0 to 10,000,000 meters)
|
|
* UTM_ZONE_ERROR : Zone outside of valid range (1 to 60)
|
|
* UTM_HEMISPHERE_ERROR : Invalid hemisphere ('N' or 'S')
|
|
* UTM_ZONE_OVERRIDE_ERROR: Zone outside of valid range
|
|
* (1 to 60) and within 1 of 'natural' zone
|
|
* UTM_A_ERROR : Semi-major axis less than or equal to zero
|
|
* UTM_INV_F_ERROR : Inverse flattening outside of valid range
|
|
* (250 to 350)
|
|
*
|
|
* REUSE NOTES
|
|
*
|
|
* UTM is intended for reuse by any application that performs a Universal
|
|
* Transverse Mercator (UTM) projection or its inverse.
|
|
*
|
|
* REFERENCES
|
|
*
|
|
* Further information on UTM can be found in the Reuse Manual.
|
|
*
|
|
* UTM 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
|
|
*
|
|
* UTM has no restrictions.
|
|
*
|
|
* ENVIRONMENT
|
|
*
|
|
* UTM was tested and certified in the following environments:
|
|
*
|
|
* 1. Solaris 2.5 with GCC, version 2.8.1
|
|
* 2. MSDOS with MS Visual C++, version 6
|
|
*
|
|
* MODIFICATIONS
|
|
*
|
|
* Date Description
|
|
* ---- -----------
|
|
* 10-02-97 Original Code
|
|
*
|
|
*/
|
|
|
|
|
|
/***************************************************************************/
|
|
/*
|
|
* DEFINES
|
|
*/
|
|
|
|
#define UTM_NO_ERROR 0x0000
|
|
#define UTM_LAT_ERROR 0x0001
|
|
#define UTM_LON_ERROR 0x0002
|
|
#define UTM_EASTING_ERROR 0x0004
|
|
#define UTM_NORTHING_ERROR 0x0008
|
|
#define UTM_ZONE_ERROR 0x0010
|
|
#define UTM_HEMISPHERE_ERROR 0x0020
|
|
#define UTM_ZONE_OVERRIDE_ERROR 0x0040
|
|
#define UTM_A_ERROR 0x0080
|
|
#define UTM_INV_F_ERROR 0x0100
|
|
|
|
|
|
/***************************************************************************/
|
|
/*
|
|
* FUNCTION PROTOTYPES
|
|
* for UTM.C
|
|
*/
|
|
|
|
/* ensure proper linkage to c++ programs */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
long Set_UTM_Parameters(double a,
|
|
double f,
|
|
long override);
|
|
/*
|
|
* The function Set_UTM_Parameters receives the ellipsoid parameters and
|
|
* UTM zone override parameter as inputs, and sets the corresponding state
|
|
* variables. If any errors occur, the error code(s) are returned by the
|
|
* function, otherwise UTM_NO_ERROR is returned.
|
|
*
|
|
* a : Semi-major axis of ellipsoid, in meters (input)
|
|
* f : Flattening of ellipsoid (input)
|
|
* override : UTM override zone, zero indicates no override (input)
|
|
*/
|
|
|
|
|
|
void Get_UTM_Parameters(double *a,
|
|
double *f,
|
|
long *override);
|
|
/*
|
|
* The function Get_UTM_Parameters returns the current ellipsoid
|
|
* parameters and UTM zone override parameter.
|
|
*
|
|
* a : Semi-major axis of ellipsoid, in meters (output)
|
|
* f : Flattening of ellipsoid (output)
|
|
* override : UTM override zone, zero indicates no override (output)
|
|
*/
|
|
|
|
|
|
long Convert_Geodetic_To_UTM (double Latitude,
|
|
double Longitude,
|
|
long *Zone,
|
|
char *Hemisphere,
|
|
double *Easting,
|
|
double *Northing);
|
|
/*
|
|
* The function Convert_Geodetic_To_UTM converts geodetic (latitude and
|
|
* longitude) coordinates to UTM projection (zone, hemisphere, easting and
|
|
* northing) coordinates according to the current ellipsoid and UTM zone
|
|
* override parameters. If any errors occur, the error code(s) are returned
|
|
* by the function, otherwise UTM_NO_ERROR is returned.
|
|
*
|
|
* Latitude : Latitude in radians (input)
|
|
* Longitude : Longitude in radians (input)
|
|
* Zone : UTM zone (output)
|
|
* Hemisphere : North or South hemisphere (output)
|
|
* Easting : Easting (X) in meters (output)
|
|
* Northing : Northing (Y) in meters (output)
|
|
*/
|
|
|
|
|
|
long Convert_UTM_To_Geodetic(long Zone,
|
|
char Hemisphere,
|
|
double Easting,
|
|
double Northing,
|
|
double *Latitude,
|
|
double *Longitude);
|
|
/*
|
|
* The function Convert_UTM_To_Geodetic converts UTM projection (zone,
|
|
* hemisphere, easting and northing) coordinates to geodetic(latitude
|
|
* and longitude) coordinates, according to the current ellipsoid
|
|
* parameters. If any errors occur, the error code(s) are returned
|
|
* by the function, otherwise UTM_NO_ERROR is returned.
|
|
*
|
|
* Zone : UTM zone (input)
|
|
* Hemisphere : North or South hemisphere (input)
|
|
* 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 /* UTM_H */
|