/****************************************************************************** * * Project: OpenGIS Simple Features * Purpose: Functions for getting list of projection types, and their parms. * Author: Frank Warmerdam, warmerdam@pobox.com * ****************************************************************************** * Copyright (c) 2000, Frank Warmerdam * Copyright (c) 2009-2011, Even Rouault * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. ****************************************************************************/ #include "cpl_port.h" #include "ogr_srs_api.h" #include #include "cpl_conv.h" #include "cpl_string.h" CPL_CVSID("$Id: ogr_opt.cpp 82bd5a1323fdb712eb5f052b3f5ea56440e4307f 2018-05-06 20:12:16 +0200 Even Rouault $") static const char * const papszParameterDefinitions[] = { SRS_PP_CENTRAL_MERIDIAN, "Central Meridian", "Long", "0.0", SRS_PP_SCALE_FACTOR, "Scale Factor", "Ratio", "1.0", SRS_PP_STANDARD_PARALLEL_1, "Standard Parallel 1", "Lat", "0.0", SRS_PP_STANDARD_PARALLEL_2, "Standard Parallel 2", "Lat", "0.0", SRS_PP_LONGITUDE_OF_CENTER, "Longitude of Center", "Long", "0.0", SRS_PP_LATITUDE_OF_CENTER, "Latitude of Center", "Lat", "0.0", SRS_PP_LONGITUDE_OF_ORIGIN, "Longitude of Origin", "Long", "0.0", SRS_PP_LATITUDE_OF_ORIGIN, "Latitude of Origin", "Lat", "0.0", SRS_PP_FALSE_EASTING, "False Easting", "m", "0.0", SRS_PP_FALSE_NORTHING, "False Northing", "m", "0.0", SRS_PP_AZIMUTH, "Azimuth", "Angle", "0.0", SRS_PP_LONGITUDE_OF_POINT_1,"Longitude of Point 1", "Long", "0.0", SRS_PP_LATITUDE_OF_POINT_1, "Latitude of Point 1", "Lat", "0.0", SRS_PP_LONGITUDE_OF_POINT_2,"Longitude of Point 2", "Long", "0.0", SRS_PP_LATITUDE_OF_POINT_2, "Latitude of Point 2", "Lat", "0.0", SRS_PP_LONGITUDE_OF_POINT_3,"Longitude of Point 3", "Long", "0.0", SRS_PP_LATITUDE_OF_POINT_3, "Latitude of Point 3", "Lat", "0.0", SRS_PP_RECTIFIED_GRID_ANGLE,"Rectified Grid Angle", "Angle", "0.0", SRS_PP_SATELLITE_HEIGHT, "Satellite Height", "m", "35785831.0", SRS_PP_PEG_POINT_LATITUDE, "Peg Point Latitude", "Lat", "0.0", SRS_PP_PEG_POINT_LONGITUDE, "Peg Point Longitude", "Long", "0.0", SRS_PP_PEG_POINT_HEADING, "Peg Point Heading", "Angle", "0.0", SRS_PP_PEG_POINT_HEIGHT, "Peg Point Height", "m", "0.0", SRS_PP_PSEUDO_STD_PARALLEL_1, "Pseudo standard parallel 1", "Lat", "0.0", SRS_PP_LATITUDE_OF_1ST_POINT, "Latitude of 1st point", "Lat", "0.0", SRS_PP_LATITUDE_OF_2ND_POINT, "Latitude of 2nd point", "Lat", "0.0", SRS_PP_LONGITUDE_OF_1ST_POINT, "Longitude of 1st point", "Lat", "0.0", SRS_PP_LONGITUDE_OF_2ND_POINT, "Longitude of 2nd point", "Long", "0.0", nullptr }; static const char * const papszProjectionDefinitions[] = { "*", SRS_PT_TRANSVERSE_MERCATOR, "Transverse Mercator", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_TRANSVERSE_MERCATOR_SOUTH_ORIENTED, "Transverse Mercator (South Oriented)", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_TUNISIA_MINING_GRID, "Tunisia Mining Grid", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ALBERS_CONIC_EQUAL_AREA, "Albers Conic Equal Area", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_STANDARD_PARALLEL_2, SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_AZIMUTHAL_EQUIDISTANT, "Azimuthal Equidistant", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_CYLINDRICAL_EQUAL_AREA, "Cylindrical Equal Area", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_CASSINI_SOLDNER, "Cassini/Soldner", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_EQUIDISTANT_CONIC, "Equidistant Conic", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_STANDARD_PARALLEL_2, SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_BONNE, "Bonne", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_I, "Eckert I", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_II, "Eckert II", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_III, "Eckert III", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_IV, "Eckert IV", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_V, "Eckert V", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ECKERT_VI, "Eckert VI", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_EQUIRECTANGULAR, "Equirectangular", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_STANDARD_PARALLEL_1, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_GAUSSSCHREIBERTMERCATOR, "Gauss-Schreiber Transverse Mercator", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_GALL_STEREOGRAPHIC, "Gall Stereographic", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_GOODE_HOMOLOSINE, "Goode Homolosine", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_IGH, "Interrupted Goode Homolosine", "*", SRS_PT_GEOSTATIONARY_SATELLITE, "Geostationary Satellite", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SATELLITE_HEIGHT, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_GNOMONIC, "Gnomonic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_HOTINE_OBLIQUE_MERCATOR, "Hotine Oblique Mercator", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_AZIMUTH, SRS_PP_RECTIFIED_GRID_ANGLE, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_HOTINE_OBLIQUE_MERCATOR_TWO_POINT_NATURAL_ORIGIN, "Hotine Oblique Mercator Two Point Natural Origin", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LATITUDE_OF_POINT_1, SRS_PP_LONGITUDE_OF_POINT_1, SRS_PP_LATITUDE_OF_POINT_2, SRS_PP_LONGITUDE_OF_POINT_2, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_LAMBERT_AZIMUTHAL_EQUAL_AREA, "Lambert Azimuthal Equal Area", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_LAMBERT_CONFORMAL_CONIC_2SP, "Lambert Conformal Conic (2SP)", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_STANDARD_PARALLEL_2, SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_LAMBERT_CONFORMAL_CONIC_1SP, "Lambert Conformal Conic (1SP)", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_LAMBERT_CONFORMAL_CONIC_2SP_BELGIUM, "Lambert Conformal Conic (2SP - Belgium)", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_STANDARD_PARALLEL_2, SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_MILLER_CYLINDRICAL, "Miller Cylindrical", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_MERCATOR_1SP, "Mercator (1SP)", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_MERCATOR_2SP, "Mercator (2SP)", SRS_PP_STANDARD_PARALLEL_1, SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_MOLLWEIDE, "Mollweide", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_NEW_ZEALAND_MAP_GRID, "New Zealand Map Grid", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_OBLIQUE_STEREOGRAPHIC, "Oblique Stereographic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ORTHOGRAPHIC, "Orthographic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_POLYCONIC, "Polyconic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_POLAR_STEREOGRAPHIC, "Polar Stereographic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_ROBINSON, "Robinson", SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_SINUSOIDAL, "Sinusoidal", SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_STEREOGRAPHIC, "Stereographic", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_TWO_POINT_EQUIDISTANT, "Two Point Equidistant", SRS_PP_LATITUDE_OF_1ST_POINT, SRS_PP_LONGITUDE_OF_1ST_POINT, SRS_PP_LATITUDE_OF_2ND_POINT, SRS_PP_LONGITUDE_OF_2ND_POINT, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_VANDERGRINTEN, "Van Der Grinten", SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_KROVAK, "Krovak", SRS_PP_LATITUDE_OF_CENTER, SRS_PP_LONGITUDE_OF_CENTER, SRS_PP_AZIMUTH, SRS_PP_PSEUDO_STD_PARALLEL_1, SRS_PP_SCALE_FACTOR, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_IMW_POLYCONIC, "International Map of the World Polyconic", SRS_PP_LATITUDE_OF_1ST_POINT, SRS_PP_LATITUDE_OF_2ND_POINT, SRS_PP_CENTRAL_MERIDIAN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_I, "Wagner I (Kavraisky VI)", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_II, "Wagner II", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_III, "Wagner III", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_IV, "Wagner IV", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_V, "Wagner V", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_VI, "Wagner VI", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_WAGNER_VII, "Wagner VII", SRS_PP_FALSE_EASTING, SRS_PP_FALSE_NORTHING, "*", SRS_PT_QSC, "Quadrilateralized Spherical Cube", SRS_PP_LATITUDE_OF_ORIGIN, SRS_PP_CENTRAL_MERIDIAN, "*", SRS_PT_SCH, "Spherical Crosstrack Height", SRS_PP_PEG_POINT_LATITUDE, SRS_PP_PEG_POINT_LONGITUDE, SRS_PP_PEG_POINT_HEADING, SRS_PP_PEG_POINT_HEIGHT, nullptr }; /************************************************************************/ /* OPTGetProjectionMethods() */ /************************************************************************/ /** * Fetch list of possible projection methods. * * @return Returns NULL terminated list of projection methods. This should * be freed with CSLDestroy() when no longer needed. */ char **OPTGetProjectionMethods() { char **papszList = nullptr; for( int i = 1; papszProjectionDefinitions[i] != nullptr; ++i ) { if( EQUAL(papszProjectionDefinitions[i-1], "*") ) papszList = CSLAddString(papszList, papszProjectionDefinitions[i]); } return papszList; } /************************************************************************/ /* OPTGetParameterList() */ /************************************************************************/ /** * Fetch the parameters for a given projection method. * * @param pszProjectionMethod internal name of projection methods to fetch * the parameters for, such as "Transverse_Mercator" * (SRS_PT_TRANSVERSE_MERCATOR). * * @param ppszUserName pointer in which to return a user visible name for * the projection name. The returned string should not be modified or * freed by the caller. Legal to pass in NULL if user name not required. * * @return returns a NULL terminated list of internal parameter names that * should be freed by the caller when no longer needed. Returns NULL if * projection method is unknown. */ char **OPTGetParameterList( const char *pszProjectionMethod, char ** ppszUserName ) { char **papszList = nullptr; for( int i = 1; papszProjectionDefinitions[i] != nullptr; ++i ) { if( papszProjectionDefinitions[i-1][0] == '*' && EQUAL(papszProjectionDefinitions[i], pszProjectionMethod) ) { ++i; if( ppszUserName != nullptr ) *ppszUserName = const_cast(papszProjectionDefinitions[i]); ++i; while( papszProjectionDefinitions[i] != nullptr && papszProjectionDefinitions[i][0] != '*' ) { papszList = CSLAddString( papszList, papszProjectionDefinitions[i] ); ++i; } // IGH has no parameter, so return an empty list instead of NULL. if( papszList == nullptr) papszList = static_cast( CPLCalloc(1, sizeof(char*)) ); return papszList; } } return nullptr; } /************************************************************************/ /* OPTGetParameterInfo() */ /************************************************************************/ /** * Fetch information about a single parameter of a projection method. * * @param pszProjectionMethod name of projection method for which the parameter * applies. Not currently used, but in the future this could affect defaults. * This is the internal projection method name, such as "Tranverse_Mercator". * * @param pszParameterName name of the parameter to fetch information about. * This is the internal name such as "central_meridian" * (SRS_PP_CENTRAL_MERIDIAN). * * @param ppszUserName location at which to return the user visible name for * the parameter. This pointer may be NULL to skip the user name. The * returned name should not be modified or freed. * * @param ppszType location at which to return the parameter type for * the parameter. This pointer may be NULL to skip. The returned type * should not be modified or freed. The type values are described above. * * @param pdfDefaultValue location at which to put the default value for * this parameter. The pointer may be NULL. * * @return TRUE if parameter found, or FALSE otherwise. */ int OPTGetParameterInfo( CPL_UNUSED const char * pszProjectionMethod, const char * pszParameterName, char ** ppszUserName, char ** ppszType, double *pdfDefaultValue ) { for( int i = 0; papszParameterDefinitions[i] != nullptr; i += 4 ) { if( EQUAL(papszParameterDefinitions[i], pszParameterName) ) { if( ppszUserName != nullptr ) *ppszUserName = const_cast(papszParameterDefinitions[i+1]); if( ppszType != nullptr ) *ppszType = const_cast(papszParameterDefinitions[i+2]); if( pdfDefaultValue != nullptr ) *pdfDefaultValue = CPLAtof(papszParameterDefinitions[i+3]); return TRUE; } } return FALSE; }