/usr/include/geotranz/dtcc/EllipsoidLibrary.h is in libgeotranz3-dev 3.3-1.
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 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 | // CLASSIFICATION: UNCLASSIFIED
#ifndef EllipsoidLibrary_H
#define EllipsoidLibrary_H
/****************************************************************************/
/* RSC IDENTIFIER: Ellipsoid Library
*
* ABSTRACT
*
* The purpose of ELLIPSOID is to provide access to ellipsoid parameters
* for a collection of common ellipsoids. A particular ellipsoid can be
* accessed by using its standard 2-letter code to find its index in the
* ellipsoid table. The index can then be used to retrieve the ellipsoid
* name and parameters.
*
* By sequentially retrieving all of the ellipsoid codes and/or names, a
* menu of the available ellipsoids can be constructed. The index values
* resulting from selections from this menu can then be used to access the
* parameters of the selected ellipsoid.
*
* This component depends on a data file named "ellips.dat", which contains
* the ellipsoid parameter values. A copy of this file must be located in
* the directory specified by the environment variable "MSPCCS_DATA", if
* defined, or else in the current directory, whenever a program containing
* this component is executed.
*
* Additional ellipsoids can be added to this file, either manually or using
* the Create_Ellipsoid function. However, if a large number of ellipsoids
* are added, the ellipsoid table array size in this component will have to
* be increased.
*
* 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:
*
* ELLIPSE_NO_ERROR : No errors occured in function
* ELLIPSE_FILE_OPEN_ERROR : Ellipsoid file opening error
* ELLIPSE_INITIALIZE_ERROR : Ellipsoid table can not initialize
* ELLIPSE_TABLE_OVERFLOW_ERROR : Ellipsoid table overflow
* ELLIPSE_NOT_INITIALIZED_ERROR: Ellipsoid table not initialized properly
* ELLIPSE_INVALID_INDEX_ERROR : Index is an invalid value
* ELLIPSE_INVALID_CODE_ERROR : Code was not found in table
* ELLIPSE_A_ERROR : Semi-major axis less than or equal to zero
* ELLIPSE_INV_F_ERROR : Inverse flattening outside of valid range
* (250 to 350)
* ELLIPSE_NOT_USERDEF_ERROR : Ellipsoid is not user defined - cannot be
* deleted
*
* REUSE NOTES
*
* Ellipsoid is intended for reuse by any application that requires Earth
* approximating ellipsoids.
*
* REFERENCES
*
* Further information on Ellipsoid can be found in the Reuse Manual.
*
* Ellipsoid originated from : U.S. Army Topographic Engineering Center (USATEC)
* Geospatial Information Division (GID)
* 7701 Telegraph Road
* Alexandria, VA 22310-3864
*
* LICENSES
*
* None apply to this component.
*
* RESTRICTIONS
*
* Ellipsoid has no restrictions.
*
* ENVIRONMENT
*
* Ellipsoid was tested and certified in the following environments
*
* 1. Solaris 2.5
* 2. Windows 95
*
* MODIFICATIONS
*
* Date Description
* ---- -----------
* 11-19-95 Original Code
* 17-Jan-97 Moved local constants out of public interface
* Improved efficiency in algorithms (GEOTRANS)
* 24-May-99 Added user-defined ellipsoids (GEOTRANS for JMTK)
* 06-27-06 Moved data file to data directory
* 03-09-07 Original C++ Code
*
*/
#include "DtccApi.h"
namespace MSP
{
namespace CCS
{
class EllipsoidLibraryImplementation;
/***************************************************************************/
/*
* DEFINES
*/
class MSP_DTCC_API EllipsoidLibrary
{
public:
/*
* The constructor creates an empty list to store the ellipsoid data from ellips.dat,
* which is used to build the ellipsoid table.
*/
EllipsoidLibrary( EllipsoidLibraryImplementation* __ellipsoidLibraryImplementation );
EllipsoidLibrary( const EllipsoidLibrary &e );
EllipsoidLibrary& operator=( const EllipsoidLibrary &e );
~EllipsoidLibrary( void );
/*
* The function defineEllipsoid creates a new ellipsoid with the specified
* Code, name, and axes. If the ellipsoid table has not been initialized,
* the specified code is already in use, or a new version of the ellips.dat
* file cannot be created, an exception is thrown.
* Note that the indexes of all ellipsoids in the ellipsoid
* table may be changed by this function.
*
* code : 2-letter ellipsoid code. (input)
* name : Name of the new ellipsoid (input)
* semiMajorAxis : Semi-major axis, in meters, of new ellipsoid (input)
* flattening : Flattening of new ellipsoid. (input)
*
*/
void defineEllipsoid( const char* code, const char* name, double semiMajorAxis, double flattening );
/*
* The function removeEllipsoid deletes a user defined ellipsoid with
* the specified Code. If the ellipsoid table has not been created,
* the specified code is in use by a user defined datum, or a new version
* of the ellips.dat file cannot be created, exception is thrown.
* Note that the indexes of all
* ellipsoids in the ellipsoid table may be changed by this function.
*
* code : 2-letter ellipsoid code. (input)
*
*/
void removeEllipsoid( const char* code );
/*
* The function getEllipsoidCount returns the number of ellipsoids in the
* ellipsoid table. If the ellipsoid table has not been initialized,
* an exception is thrown.
*
* count : The number of ellipsoids in the ellipsoid table. (output)
*
*/
void getEllipsoidCount ( long *count );
/*
* The function getEllipsoidIndex returns the index of the ellipsoid in
* the ellipsoid table with the specified code. If ellipsoid code is not found,
* an exception is thrown.
*
* code : 2-letter ellipsoid code. (input)
* index : Index of the ellipsoid in the ellipsoid table with the
* specified code (output)
*
*/
void getEllipsoidIndex( const char *code, long* index );
/*
* The Function getEllipsoidInfo returns the 2-letter code and name of the
* ellipsoid in the ellipsoid table with the specified index. If index is
* invalid, an exception is thrown.
*
* index : Index of a given ellipsoid in the ellipsoid table (input)
* code : 2-letter ellipsoid code. (output)
* name : Name of the ellipsoid referencd by index (output)
*
*/
void getEllipsoidInfo( const long index, char *code, char *name );
/*
* The function getEllipsoidParameters returns the semi-major axis and flattening
* for the ellipsoid with the specified index. If index is invalid,
* an exception is thrown.
*
* index : Index of a given ellipsoid in the ellipsoid table (input)
* a : Semi-major axis, in meters, of ellipsoid (output)
* f : Flattening of ellipsoid. (output)
*
*/
void getEllipsoidParameters( const long index, double *a, double *f );
private:
EllipsoidLibraryImplementation* _ellipsoidLibraryImplementation;
};
}
}
#endif
// CLASSIFICATION: UNCLASSIFIED
|