/usr/include/ossim/projection/ossimSinusoid.h is in libossim-dev 1.7.21-3ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | #ifndef SINUSOID_H
#define SINUSOID_H
/***************************************************************************/
/* RSC IDENTIFIER: SINUSOIDAL
*
* ABSTRACT
*
* This component provides conversions between Geodetic coordinates
* (latitude and longitude in radians) and Sinusoid projection coordinates
* (easting and northing in meters).
*
* 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:
*
* SINU_NO_ERROR : No errors occurred in function
* SINU_LAT_ERROR : Latitude outside of valid range
* (-90 to 90 degrees)
* SINU_LON_ERROR : Longitude outside of valid range
* (-180 to 360 degrees)
* SINU_EASTING_ERROR : Easting outside of valid range
* (False_Easting +/- ~20,000,000 m,
* depending on ellipsoid parameters)
* SINU_NORTHING_ERROR : Northing outside of valid range
* (False_Northing +/- ~10,000,000 m,
* depending on ellipsoid parameters)
* SINU_CENT_MER_ERROR : Origin longitude outside of valid range
* (-180 to 360 degrees)
* SINU_A_ERROR : Semi-major axis less than or equal to zero
* SINU_INV_F_ERROR : Inverse flattening outside of valid range
* (250 to 350)
*
* REUSE NOTES
*
* SINUSOIDAL is intended for reuse by any application that performs a
* Sinusoid projection or its inverse.
*
* REFERENCES
*
* Further information on SINUSOIDAL can be found in the Reuse Manual.
*
* SINUSOIDAL 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
*
* SINUSOIDAL has no restrictions.
*
* ENVIRONMENT
*
* SINUSOIDAL 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
* ---- -----------
* 7-15-99 Original Code
*
*/
/***************************************************************************/
/*
* DEFINES
*/
#define SINU_NO_ERROR 0x0000
#define SINU_LAT_ERROR 0x0001
#define SINU_LON_ERROR 0x0002
#define SINU_EASTING_ERROR 0x0004
#define SINU_NORTHING_ERROR 0x0008
#define SINU_CENT_MER_ERROR 0x0020
#define SINU_A_ERROR 0x0040
#define SINU_INV_F_ERROR 0x0080
/***************************************************************************/
/*
* FUNCTION PROTOTYPES
* for SINUSOID.C
*/
/* ensure proper linkage to c++ programs */
#ifdef __cplusplus
extern "C" {
#endif
long Set_Sinusoidal_Parameters(double a,
double f,
double Central_Meridian,
double False_Easting,
double False_Northing);
/*
* The function Set_Sinusoidal_Parameters receives the ellipsoid parameters and
* Sinusoidal projcetion parameters as inputs, and sets the corresponding state
* variables. If any errors occur, the error code(s) are returned by the function,
* otherwise SINU_NO_ERROR is returned.
*
* a : Semi-major axis of ellipsoid, in meters (input)
* f : Flattening of ellipsoid (input)
* Central_Meridian : Longitude in radians at the center of (input)
* the projection
* False_Easting : A coordinate value in meters assigned to the
* central meridian of the projection. (input)
* False_Northing : A coordinate value in meters assigned to the
* origin latitude of the projection (input)
*/
void Get_Sinusoidal_Parameters(double *a,
double *f,
double *Central_Meridian,
double *False_Easting,
double *False_Northing);
/*
* The function Get_Sinusoidal_Parameters returns the current ellipsoid
* parameters and Sinusoidal projection parameters.
*
* a : Semi-major axis of ellipsoid, in meters (output)
* f : Flattening of ellipsoid (output)
* Central_Meridian : Longitude in radians at the center of (output)
* the projection
* False_Easting : A coordinate value in meters assigned to the
* central meridian of the projection. (output)
* False_Northing : A coordinate value in meters assigned to the
* origin latitude of the projection (output)
*/
long Convert_Geodetic_To_Sinusoidal (double Latitude,
double Longitude,
double *Easting,
double *Northing);
/*
* The function Convert_Geodetic_To_Sinusoidal converts geodetic (latitude and
* longitude) coordinates to Sinusoidal projection easting, and northing
* coordinates, according to the current ellipsoid and Sinusoidal projection
* parameters. If any errors occur, the error code(s) are returned by the
* function, otherwise SINU_NO_ERROR is returned.
*
* Latitude : Latitude (phi) in radians (input)
* Longitude : Longitude (lambda) in radians (input)
* Easting : Easting (X) in meters (output)
* Northing : Northing (Y) in meters (output)
*/
long Convert_Sinusoidal_To_Geodetic(double Easting,
double Northing,
double *Latitude,
double *Longitude);
/*
* The function Convert_Sinusoidal_To_Geodetic converts Sinusoidal projection
* easting and northing coordinates to geodetic (latitude and longitude)
* coordinates, according to the current ellipsoid and Sinusoida projection
* coordinates. If any errors occur, the error code(s) are returned by the
* function, otherwise SINU_NO_ERROR is returned.
*
* Easting : Easting (X) in meters (input)
* Northing : Northing (Y) in meters (input)
* Latitude : Latitude (phi) in radians (output)
* Longitude : Longitude (lambda) in radians (output)
*/
#ifdef __cplusplus
}
#endif
#endif /* SINUSOID_H */
|