| gvSIG desktop 1

/******************************************************************************

 * $Id: ogr_srs_api.h 8219 2006-10-23 06:25:39Z nacho $

 *

 * Project:  OpenGIS Simple Features Reference Implementation

 * Purpose:  C API and constant declarations for OGR Spatial References.

 * Author:   Frank Warmerdam, warmerda@home.com

 *

 ******************************************************************************

 * Copyright (c) 2000, Frank Warmerdam

 *

 * 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.

 ******************************************************************************

 *

 * $Log$

 * Revision 1.1  2006-10-23 06:25:39  nacho

 * *** empty log message ***

 *

 * Revision 1.1  2006/06/29 16:23:27  nacho

 * *** empty log message ***

 *

 * Revision 1.2  2006/01/09 12:50:13  nacho

 * *** empty log message ***

 *

 * Revision 1.1  2005/07/27 08:22:55  igbrotru

 * *** empty log message ***

 *

 * Revision 1.1  2004/12/28 14:06:59  igbrotru

 * *** empty log message ***

 *

 * Revision 1.1  2004/12/28 13:32:25  igbrotru

 * *** empty log message ***

 *

 * Revision 1.46  2004/09/23 16:20:13  fwarmerdam

 * added OSRCleanup

 *

 * Revision 1.45  2004/05/12 19:25:54  dron

 * SRS_DN_WGS72 constant added.

 *

 * Revision 1.44  2004/05/10 17:05:14  warmerda

 * added AutoIdentifyEPSG()

 *

 * Revision 1.43  2004/05/06 19:26:04  dron

 * Added OSRSetProjection() function.

 *

 * Revision 1.42  2004/03/04 18:04:45  warmerda

 * added importFromDict() support

 *

 * Revision 1.41  2004/02/07 17:31:21  dron

 * Added OSRExportToUSGS() method.

 *

 * Revision 1.40  2004/02/05 17:07:59  dron

 * Support for HOM projection, specified by two points on centerline.

 *

 * Revision 1.39  2004/02/01 14:23:29  dron

 * Added OSRImportFromUSGS().

 *

 * Revision 1.38  2004/01/24 09:35:00  warmerda

 * added TransformEx support to capture per point reprojection failure

 *

 * Revision 1.37  2003/09/09 07:49:52  dron

 * Added OSRExportToPCI().

 *

 * Revision 1.36  2003/08/31 14:51:01  dron

 * Added OSRImportFromPCI().

 *

 * Revision 1.35  2003/08/18 13:26:01  warmerda

 * added SetTMVariant() and related definitions

 *

 * Revision 1.34  2003/06/21 23:24:36  warmerda

 * added Set/Get TOWGS84 calls

 *

 * Revision 1.33  2003/06/19 17:10:26  warmerda

 * a couple fixes in last commit

 *

 * Revision 1.32  2003/06/18 18:24:17  warmerda

 * added projection specific set methods to C API

 *

 * Revision 1.31  2003/06/10 09:31:12  dron

 * Added OSRSetAngularUnits() and OSRGetAngularUnits().

 *

 * Revision 1.30  2003/05/30 15:39:53  warmerda

 * Added override units capability for SetStatePlane()

 *

 * Revision 1.29  2003/03/21 22:15:11  warmerda

 * added C XML import/export entry points

 *

 * Revision 1.28  2003/03/12 14:29:34  warmerda

 * Rename OGRAxisOrientation and OGRDatumType values to avoid conflicts with

 * the real OGC definitions in applications such as Cadcorps.

 *

 * Revision 1.27  2003/02/25 04:53:38  warmerda

 * added OSRCopyGeogCSFrom

 *

 * Revision 1.26  2003/02/06 04:53:12  warmerda

 * added Fixup() method

 *

 * Revision 1.25  2003/01/08 18:14:28  warmerda

 * added FixupOrdering()

 *

 * Revision 1.24  2002/12/16 17:07:13  warmerda

 * added NormProjParm functions, and OSRGetPrimeMeridian

 *

 * Revision 1.23  2002/12/14 22:59:14  warmerda

 * added Krovak in ESRI compatible way

 *

 * Revision 1.22  2002/12/09 18:55:07  warmerda

 * moved DMS stuff to gdal/port

 *

 * Revision 1.21  2002/12/09 16:11:53  warmerda

 * added DMS translation

 *

 * Revision 1.20  2002/11/25 16:12:54  warmerda

 * added GetAuthorityCode/Name

 *

 * Revision 1.19  2002/09/26 18:13:25  warmerda

 * avoid double def

 *

 * Revision 1.18  2002/06/11 18:02:03  warmerda

 * add PROJ.4 normalization and EPSG support

 *

 * Revision 1.17  2001/10/11 19:27:12  warmerda

 * upgraded validation infrastructure

 *

 * Revision 1.16  2001/10/10 20:42:43  warmerda

 * added ESRI WKT morphing support

 *

 * Revision 1.15  2001/09/21 16:21:02  warmerda

 * added Clear(), and SetFromUserInput() methods

 *

 * Revision 1.14  2000/11/09 06:21:32  warmerda

 * added limited ESRI prj support

 *

 * Revision 1.13  2000/10/20 04:19:38  warmerda

 * added setstateplane

 *

 * Revision 1.12  2000/10/16 21:26:07  warmerda

 * added some level of LOCAL_CS support

 *

 * Revision 1.11  2000/09/01 20:58:01  warmerda

 * added CPL_DLL for entry points

 *

 * Revision 1.10  2000/08/30 20:06:14  warmerda

 * added projection method list functions

 *

 * Revision 1.9  2000/08/28 20:13:23  warmerda

 * added importFromProj4

 *

 * Revision 1.8  2000/07/11 01:02:06  warmerda

 * added ExportToProj4()

 *

 * Revision 1.7  2000/07/09 20:48:02  warmerda

 * added exportToPrettyWkt

 *

 * Revision 1.6  2000/05/30 22:45:44  warmerda

 * added OSRCloneGeogCS()

 *

 * Revision 1.5  2000/04/26 18:25:56  warmerda

 * added missing CPL_DLL attributes

 *

 * Revision 1.4  2000/03/22 01:09:43  warmerda

 * added SetProjCS and SetWellKnownTextCS

 *

 * Revision 1.3  2000/03/20 23:33:51  warmerda

 * updated docs a bit

 *

 * Revision 1.2  2000/03/20 22:39:31  warmerda

 * Added C API.

 *

 * Revision 1.1  2000/03/16 19:04:14  warmerda

 * New

 *

 */

#ifndef _OGR_SRS_API_H_INCLUDED

#define _OGR_SRS_API_H_INCLUDED

#include "ogr_core.h"

CPL_C_START

/**

 * \file ogr_srs_api.h

 * 

 * C spatial reference system services and defines.

 * 

 * See also: ogr_spatialref.h

 */

/* -------------------------------------------------------------------- */

/*      Axis orientations (corresponds to CS_AxisOrientationEnum).      */

/* -------------------------------------------------------------------- */

typedef enum {

    OAO_Other=0,

    OAO_North=1,

    OAO_South=2,

    OAO_East=3,

    OAO_West=4,

    OAO_Up=5,

    OAO_Down=6

} OGRAxisOrientation;

/* -------------------------------------------------------------------- */

/*      Datum types (corresponds to CS_DatumType).                      */

/* -------------------------------------------------------------------- */

typedef enum {

    ODT_HD_Min=1000,

    ODT_HD_Other=1000,

    ODT_HD_Classic=1001,

    ODT_HD_Geocentric=1002,

    ODT_HD_Max=1999,

    ODT_VD_Min=2000,

    ODT_VD_Other=2000,

    ODT_VD_Orthometric=2001,

    ODT_VD_Ellipsoidal=2002,

    ODT_VD_AltitudeBarometric=2003,

    ODT_VD_Normal=2004,

    ODT_VD_GeoidModelDerived=2005,

    ODT_VD_Depth=2006,

    ODT_VD_Max=2999,

    ODT_LD_Min=10000,

    ODT_LD_Max=32767

} OGRDatumType; 

/* ==================================================================== */

/*      Some "standard" strings.                                        */

/* ==================================================================== */

#define SRS_PT_ALBERS_CONIC_EQUAL_AREA                                  \

                                "Albers_Conic_Equal_Area"

#define SRS_PT_AZIMUTHAL_EQUIDISTANT "Azimuthal_Equidistant"

#define SRS_PT_CASSINI_SOLDNER  "Cassini_Soldner"

#define SRS_PT_CYLINDRICAL_EQUAL_AREA "Cylindrical_Equal_Area"

#define SRS_PT_ECKERT_IV        "Eckert_IV"

#define SRS_PT_ECKERT_VI        "Eckert_VI"

#define SRS_PT_EQUIDISTANT_CONIC "Equidistant_Conic"

#define SRS_PT_EQUIRECTANGULAR  "Equirectangular"

#define SRS_PT_GALL_STEREOGRAPHIC "Gall_Stereographic"

#define SRS_PT_GNOMONIC         "Gnomonic"

#define SRS_PT_HOTINE_OBLIQUE_MERCATOR                                  \

                                "Hotine_Oblique_Mercator"

#define SRS_PT_HOTINE_OBLIQUE_MERCATOR_TWO_POINT_NATURAL_ORIGIN         \

                            "Hotine_Oblique_Mercator_Two_Point_Natural_Origin"

#define SRS_PT_LABORDE_OBLIQUE_MERCATOR                                 \

                                "Laborde_Oblique_Mercator"

#define SRS_PT_LAMBERT_CONFORMAL_CONIC_1SP                              \

                                "Lambert_Conformal_Conic_1SP"

#define SRS_PT_LAMBERT_CONFORMAL_CONIC_2SP                              \

                                "Lambert_Conformal_Conic_2SP"

#define SRS_PT_LAMBERT_CONFORMAL_CONIC_2SP_BELGIUM                      \

                                "Lambert_Conformal_Conic_2SP_Belgium)"

#define SRS_PT_LAMBERT_AZIMUTHAL_EQUAL_AREA                     \

                                "Lambert_Azimuthal_Equal_Area"

#define SRS_PT_MERCATOR_1SP     "Mercator_1SP"

#define SRS_PT_MERCATOR_2SP     "Mercator_2SP"

#define SRS_PT_MILLER_CYLINDRICAL "Miller_Cylindrical"

#define SRS_PT_MOLLWEIDE        "Mollweide"

#define SRS_PT_NEW_ZEALAND_MAP_GRID                                     \

                                "New_Zealand_Map_Grid"

#define SRS_PT_OBLIQUE_STEREOGRAPHIC                                    \

                                "Oblique_Stereographic"

#define SRS_PT_ORTHOGRAPHIC     "Orthographic"

#define SRS_PT_POLAR_STEREOGRAPHIC                                      \

                                "Polar_Stereographic"

#define SRS_PT_POLYCONIC        "Polyconic"

#define SRS_PT_ROBINSON         "Robinson"

#define SRS_PT_SINUSOIDAL       "Sinusoidal"

#define SRS_PT_STEREOGRAPHIC    "Stereographic"

#define SRS_PT_SWISS_OBLIQUE_CYLINDRICAL                                \

                                "Swiss_Oblique_Cylindrical"

#define SRS_PT_TRANSVERSE_MERCATOR                                      \

                                "Transverse_Mercator"

#define SRS_PT_TRANSVERSE_MERCATOR_SOUTH_ORIENTED                       \

                                "Transverse_Mercator_South_Orientated"

/* special mapinfo variants on Transverse Mercator */

#define SRS_PT_TRANSVERSE_MERCATOR_MI_22 \

                                "Transverse_Mercator_MapInfo_22"

#define SRS_PT_TRANSVERSE_MERCATOR_MI_23 \

                                "Transverse_Mercator_MapInfo_23"

#define SRS_PT_TRANSVERSE_MERCATOR_MI_24 \

                                "Transverse_Mercator_MapInfo_24"

#define SRS_PT_TRANSVERSE_MERCATOR_MI_25 \

                                "Transverse_Mercator_MapInfo_25"

#define SRS_PT_TUNISIA_MINING_GRID                                      \

                                "Tunisia_Mining_Grid"

#define SRS_PT_VANDERGRINTEN    "VanDerGrinten"

#define SRS_PT_KROVAK           "Krovak"

#define SRS_PP_CENTRAL_MERIDIAN         "central_meridian"

#define SRS_PP_SCALE_FACTOR             "scale_factor"

#define SRS_PP_STANDARD_PARALLEL_1      "standard_parallel_1"

#define SRS_PP_STANDARD_PARALLEL_2      "standard_parallel_2"

#define SRS_PP_PSEUDO_STD_PARALLEL_1    "pseudo_standard_parallel_1"

#define SRS_PP_LONGITUDE_OF_CENTER      "longitude_of_center"

#define SRS_PP_LATITUDE_OF_CENTER       "latitude_of_center"

#define SRS_PP_LONGITUDE_OF_ORIGIN      "longitude_of_origin"

#define SRS_PP_LATITUDE_OF_ORIGIN       "latitude_of_origin"

#define SRS_PP_FALSE_EASTING            "false_easting"

#define SRS_PP_FALSE_NORTHING           "false_northing"

#define SRS_PP_AZIMUTH                  "azimuth"

#define SRS_PP_LONGITUDE_OF_POINT_1     "longitude_of_point_1"

#define SRS_PP_LATITUDE_OF_POINT_1      "latitude_of_point_1"

#define SRS_PP_LONGITUDE_OF_POINT_2     "longitude_of_point_2"

#define SRS_PP_LATITUDE_OF_POINT_2      "latitude_of_point_2"

#define SRS_PP_LONGITUDE_OF_POINT_3     "longitude_of_point_3"

#define SRS_PP_LATITUDE_OF_POINT_3      "latitude_of_point_3"

#define SRS_PP_RECTIFIED_GRID_ANGLE     "rectified_grid_angle"

#define SRS_PP_LANDSAT_NUMBER           "landsat_number"

#define SRS_PP_PATH_NUMBER              "path_number"

#define SRS_PP_PERSPECTIVE_POINT_HEIGHT "perspective_point_height"

#define SRS_PP_FIPSZONE                 "fipszone"

#define SRS_PP_ZONE                     "zone"

#define SRS_UL_METER            "Meter"

#define SRS_UL_FOOT             "Foot (International)" /* or just "FOOT"? */

#define SRS_UL_FOOT_CONV                    "0.3048"

#define SRS_UL_US_FOOT          "U.S. Foot" /* or "US survey foot" */

#define SRS_UL_US_FOOT_CONV                 "0.3048006"

#define SRS_UL_NAUTICAL_MILE    "Nautical Mile"

#define SRS_UL_NAUTICAL_MILE_CONV           "1852.0"

#define SRS_UL_LINK             "Link"          /* Based on US Foot */

#define SRS_UL_LINK_CONV                    "0.20116684023368047"

#define SRS_UL_CHAIN            "Chain"         /* based on US Foot */

#define SRS_UL_CHAIN_CONV                   "2.0116684023368047"

#define SRS_UL_ROD              "Rod"           /* based on US Foot */

#define SRS_UL_ROD_CONV                     "5.02921005842012"

#define SRS_UA_DEGREE           "degree"

#define SRS_UA_DEGREE_CONV                  "0.0174532925199433"

#define SRS_UA_RADIAN           "radian"

#define SRS_PM_GREENWICH        "Greenwich"

#define SRS_DN_NAD27            "North_American_Datum_1927"

#define SRS_DN_NAD83            "North_American_Datum_1983"

#define SRS_DN_WGS72            "WGS_1972"

#define SRS_DN_WGS84            "WGS_1984"

#define SRS_WGS84_SEMIMAJOR     6378137.0                                

#define SRS_WGS84_INVFLATTENING 298.257223563

/* -------------------------------------------------------------------- */

/*      C Wrappers for C++ objects and methods.                         */

/* -------------------------------------------------------------------- */

#ifndef _DEFINED_OGRSpatialReferenceH

#define _DEFINED_OGRSpatialReferenceH

typedef void *OGRSpatialReferenceH;                               

typedef void *OGRCoordinateTransformationH;

#endif

OGRSpatialReferenceH CPL_DLL

      OSRNewSpatialReference( const char * /* = NULL */);

OGRSpatialReferenceH CPL_DLL OSRCloneGeogCS( OGRSpatialReferenceH );

OGRSpatialReferenceH CPL_DLL OSRCloneCS( OGRSpatialReferenceH );

void CPL_DLL OSRDestroySpatialReference( OGRSpatialReferenceH );

int CPL_DLL OSRReference( OGRSpatialReferenceH );

int CPL_DLL OSRDereference( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRValidate( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRFixupOrdering( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRFixup( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRStripCTParms( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRImportFromEPSG( OGRSpatialReferenceH, int );

OGRErr CPL_DLL OSRImportFromWkt( OGRSpatialReferenceH, char ** );

OGRErr CPL_DLL OSRImportFromProj4( OGRSpatialReferenceH, const char *);

OGRErr CPL_DLL OSRImportFromESRI( OGRSpatialReferenceH, char **);

OGRErr CPL_DLL OSRImportFromPCI( OGRSpatialReferenceH hSRS, const char *,

                                 const char *, double * );

OGRErr CPL_DLL OSRImportFromUSGS( OGRSpatialReferenceH,

                                  long, long, double *, long);

OGRErr CPL_DLL OSRImportFromXML( OGRSpatialReferenceH, const char * );

OGRErr CPL_DLL OSRImportFromDict( OGRSpatialReferenceH, const char *, 

                                  const char * );

OGRErr CPL_DLL OSRExportToWkt( OGRSpatialReferenceH, char ** );

OGRErr CPL_DLL OSRExportToPrettyWkt( OGRSpatialReferenceH, char **, int);

OGRErr CPL_DLL OSRExportToProj4( OGRSpatialReferenceH, char **);

OGRErr CPL_DLL OSRExportToPCI( OGRSpatialReferenceH, char **, char **,

                               double ** );

OGRErr CPL_DLL OSRExportToUSGS( OGRSpatialReferenceH, long *, long *,

                                double **, long * );

OGRErr CPL_DLL OSRExportToXML( OGRSpatialReferenceH, char **, const char * );

OGRErr CPL_DLL OSRMorphToESRI( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRMorphFromESRI( OGRSpatialReferenceH );

OGRErr CPL_DLL OSRSetAttrValue( OGRSpatialReferenceH hSRS,

                                const char * pszNodePath,

                                const char * pszNewNodeValue );

const char CPL_DLL * OSRGetAttrValue( OGRSpatialReferenceH hSRS,

                           const char * pszName, int iChild /* = 0 */ );

OGRErr CPL_DLL OSRSetAngularUnits( OGRSpatialReferenceH, const char *, double );

double CPL_DLL OSRGetAngularUnits( OGRSpatialReferenceH, char ** );

OGRErr CPL_DLL OSRSetLinearUnits( OGRSpatialReferenceH, const char *, double );

double CPL_DLL OSRGetLinearUnits( OGRSpatialReferenceH, char ** );

double CPL_DLL OSRGetPrimeMeridian( OGRSpatialReferenceH, char ** );

int CPL_DLL OSRIsGeographic( OGRSpatialReferenceH );

int CPL_DLL OSRIsLocal( OGRSpatialReferenceH );

int CPL_DLL OSRIsProjected( OGRSpatialReferenceH );

int CPL_DLL OSRIsSameGeogCS( OGRSpatialReferenceH, OGRSpatialReferenceH );

int CPL_DLL OSRIsSame( OGRSpatialReferenceH, OGRSpatialReferenceH );

OGRErr CPL_DLL OSRSetLocalCS( OGRSpatialReferenceH hSRS, const char *pszName );

OGRErr CPL_DLL OSRSetProjCS( OGRSpatialReferenceH hSRS, const char * pszName );

OGRErr CPL_DLL OSRSetWellKnownGeogCS( OGRSpatialReferenceH hSRS,

                                      const char * pszName );

OGRErr CPL_DLL OSRSetFromUserInput( OGRSpatialReferenceH hSRS, 

                                    const char * );

OGRErr CPL_DLL OSRCopyGeogCSFrom( OGRSpatialReferenceH hSRS, 

                                  OGRSpatialReferenceH hSrcSRS );

OGRErr CPL_DLL OSRSetTOWGS84( OGRSpatialReferenceH hSRS, 

                              double, double, double, 

                              double, double, double, double );

OGRErr CPL_DLL OSRGetTOWGS84( OGRSpatialReferenceH hSRS, double *, int );

OGRErr CPL_DLL OSRSetGeogCS( OGRSpatialReferenceH hSRS,

                      const char * pszGeogName,

                      const char * pszDatumName,

                      const char * pszEllipsoidName,

                      double dfSemiMajor, double dfInvFlattening,

                      const char * pszPMName /* = NULL */,

                      double dfPMOffset /* = 0.0 */,

                      const char * pszUnits /* = NULL */,

                      double dfConvertToRadians /* = 0.0 */ );

double CPL_DLL OSRGetSemiMajor( OGRSpatialReferenceH, OGRErr * /* = NULL */ );

double CPL_DLL OSRGetSemiMinor( OGRSpatialReferenceH, OGRErr * /* = NULL */ );

double CPL_DLL OSRGetInvFlattening( OGRSpatialReferenceH, OGRErr * /*=NULL*/);

OGRErr CPL_DLL OSRSetAuthority( OGRSpatialReferenceH hSRS,

                         const char * pszTargetKey,

                         const char * pszAuthority,

                         int nCode );

const char CPL_DLL *OSRGetAuthorityCode( OGRSpatialReferenceH hSRS,

                                         const char * pszTargetKey );

const char CPL_DLL *OSRGetAuthorityName( OGRSpatialReferenceH hSRS,

                                         const char * pszTargetKey );

OGRErr CPL_DLL OSRSetProjection( OGRSpatialReferenceH, const char * );

OGRErr CPL_DLL OSRSetProjParm( OGRSpatialReferenceH, const char *, double );

double CPL_DLL OSRGetProjParm( OGRSpatialReferenceH hSRS,

                        const char * pszParmName, 

                        double dfDefault /* = 0.0 */,

                        OGRErr * /* = NULL */ );

OGRErr CPL_DLL OSRSetNormProjParm( OGRSpatialReferenceH, const char *, double);

double CPL_DLL OSRGetNormProjParm( OGRSpatialReferenceH hSRS,

                                   const char * pszParmName, 

                                   double dfDefault /* = 0.0 */,

                                   OGRErr * /* = NULL */ );

OGRErr CPL_DLL OSRSetUTM( OGRSpatialReferenceH hSRS, int nZone, int bNorth );

int    CPL_DLL OSRGetUTMZone( OGRSpatialReferenceH hSRS, int *pbNorth );

OGRErr CPL_DLL OSRSetStatePlane( OGRSpatialReferenceH hSRS, 

                                 int nZone, int bNAD83 );

OGRErr CPL_DLL OSRSetStatePlaneWithUnits( OGRSpatialReferenceH hSRS, 

                                          int nZone, int bNAD83,

                                          const char *pszOverrideUnitName,

                                          double dfOverrideUnit );

OGRErr CPL_DLL OSRAutoIdentifyEPSG( OGRSpatialReferenceH hSRS );

/** Albers Conic Equal Area */

OGRErr CPL_DLL OSRSetACEA( OGRSpatialReferenceH hSRS, double dfStdP1, double dfStdP2,

                         double dfCenterLat, double dfCenterLong,

                         double dfFalseEasting, double dfFalseNorthing );

/** Azimuthal Equidistant */

OGRErr CPL_DLL  OSRSetAE( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                       double dfFalseEasting, double dfFalseNorthing );

/** Cylindrical Equal Area */

OGRErr CPL_DLL OSRSetCEA( OGRSpatialReferenceH hSRS, double dfStdP1, double dfCentralMeridian,

                        double dfFalseEasting, double dfFalseNorthing );

/** Cassini-Soldner */

OGRErr CPL_DLL OSRSetCS( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                       double dfFalseEasting, double dfFalseNorthing );

/** Equidistant Conic */

OGRErr CPL_DLL OSRSetEC( OGRSpatialReferenceH hSRS, double dfStdP1, double dfStdP2,

                       double dfCenterLat, double dfCenterLong,

                       double dfFalseEasting, double dfFalseNorthing );

/** Eckert IV */

OGRErr CPL_DLL OSRSetEckertIV( OGRSpatialReferenceH hSRS, double dfCentralMeridian,

                             double dfFalseEasting, double dfFalseNorthing );

/** Eckert VI */

OGRErr CPL_DLL OSRSetEckertVI( OGRSpatialReferenceH hSRS, double dfCentralMeridian,

                             double dfFalseEasting, double dfFalseNorthing );

/** Equirectangular */

OGRErr CPL_DLL OSRSetEquirectangular(OGRSpatialReferenceH hSRS,

                              double dfCenterLat, double dfCenterLong,

                              double dfFalseEasting, double dfFalseNorthing );

/** Gall Stereograpic */

OGRErr CPL_DLL OSRSetGS( OGRSpatialReferenceH hSRS, double dfCentralMeridian,

                       double dfFalseEasting, double dfFalseNorthing );

/** Gnomonic */

OGRErr CPL_DLL OSRSetGnomonic(OGRSpatialReferenceH hSRS,

                              double dfCenterLat, double dfCenterLong,

                            double dfFalseEasting, double dfFalseNorthing );

/** Hotine Oblique Mercator using azimuth angle */

OGRErr CPL_DLL OSRSetHOM( OGRSpatialReferenceH hSRS,

                          double dfCenterLat, double dfCenterLong,

                          double dfAzimuth, double dfRectToSkew,

                          double dfScale,

                          double dfFalseEasting, double dfFalseNorthing );

/** Hotine Oblique Mercator using two points on centerline */

OGRErr CPL_DLL OSRSetHOM2PNO( OGRSpatialReferenceH hSRS, double dfCenterLat,

                              double dfLat1, double dfLong1,

                              double dfLat2, double dfLong2,

                              double dfScale,

                              double dfFalseEasting, double dfFalseNorthing );

/** Krovak Oblique Conic Conformal */

OGRErr CPL_DLL OSRSetKrovak( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                           double dfAzimuth, double dfPseudoStdParallelLat,

                           double dfScale, 

                           double dfFalseEasting, double dfFalseNorthing );

/** Lambert Azimuthal Equal-Area */

OGRErr CPL_DLL OSRSetLAEA( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                         double dfFalseEasting, double dfFalseNorthing );

/** Lambert Conformal Conic */

OGRErr CPL_DLL OSRSetLCC( OGRSpatialReferenceH hSRS, double dfStdP1, double dfStdP2,

                        double dfCenterLat, double dfCenterLong,

                        double dfFalseEasting, double dfFalseNorthing );

/** Lambert Conformal Conic 1SP */

OGRErr CPL_DLL OSRSetLCC1SP( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                           double dfScale,

                           double dfFalseEasting, double dfFalseNorthing );

/** Lambert Conformal Conic (Belgium) */

OGRErr CPL_DLL OSRSetLCCB( OGRSpatialReferenceH hSRS, double dfStdP1, double dfStdP2,

                         double dfCenterLat, double dfCenterLong,

                         double dfFalseEasting, double dfFalseNorthing );

/** Miller Cylindrical */

OGRErr CPL_DLL OSRSetMC( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                       double dfFalseEasting, double dfFalseNorthing );

/** Mercator */

OGRErr CPL_DLL OSRSetMercator( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                             double dfScale, 

                             double dfFalseEasting, double dfFalseNorthing );

/** Mollweide */

OGRErr CPL_DLL  OSRSetMollweide( OGRSpatialReferenceH hSRS, double dfCentralMeridian,

                              double dfFalseEasting, double dfFalseNorthing );

/** New Zealand Map Grid */

OGRErr CPL_DLL OSRSetNZMG( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                         double dfFalseEasting, double dfFalseNorthing );

/** Oblique Stereographic */

OGRErr CPL_DLL OSRSetOS( OGRSpatialReferenceH hSRS, double dfOriginLat, double dfCMeridian,

                       double dfScale,

                       double dfFalseEasting,double dfFalseNorthing);

/** Orthographic */

OGRErr CPL_DLL OSRSetOrthographic( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                                 double dfFalseEasting,double dfFalseNorthing);

/** Polyconic */

OGRErr CPL_DLL OSRSetPolyconic( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                              double dfFalseEasting, double dfFalseNorthing );

/** Polar Stereographic */

OGRErr CPL_DLL OSRSetPS( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                       double dfScale,

                       double dfFalseEasting, double dfFalseNorthing);

/** Robinson */

OGRErr CPL_DLL OSRSetRobinson( OGRSpatialReferenceH hSRS, double dfCenterLong, 

                             double dfFalseEasting, double dfFalseNorthing );

/** Sinusoidal */

OGRErr CPL_DLL OSRSetSinusoidal( OGRSpatialReferenceH hSRS, double dfCenterLong, 

                               double dfFalseEasting, double dfFalseNorthing );

/** Stereographic */

OGRErr CPL_DLL OSRSetStereographic( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                                  double dfScale,

                                 double dfFalseEasting,double dfFalseNorthing);

/** Swiss Oblique Cylindrical */

OGRErr CPL_DLL OSRSetSOC( OGRSpatialReferenceH hSRS, double dfLatitudeOfOrigin, double dfCentralMeridian,

                        double dfFalseEasting, double dfFalseNorthing );

/** Transverse Mercator */

OGRErr CPL_DLL OSRSetTM( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong,

                       double dfScale,

                       double dfFalseEasting, double dfFalseNorthing );

/** Transverse Mercator variant */

OGRErr CPL_DLL OSRSetTMVariant( 

    OGRSpatialReferenceH hSRS, const char *pszVariantName,

    double dfCenterLat, double dfCenterLong,

    double dfScale,

    double dfFalseEasting, double dfFalseNorthing );

/** Tunesia Mining Grid  */

OGRErr CPL_DLL OSRSetTMG( OGRSpatialReferenceH hSRS, double dfCenterLat, double dfCenterLong, 

                        double dfFalseEasting, double dfFalseNorthing );

/** Transverse Mercator (South Oriented) */

OGRErr CPL_DLL OSRSetTMSO( OGRSpatialReferenceH hSRS,

                           double dfCenterLat, double dfCenterLong,

                           double dfScale,

                           double dfFalseEasting, double dfFalseNorthing );

/** VanDerGrinten */

OGRErr CPL_DLL OSRSetVDG( OGRSpatialReferenceH hSRS,

                          double dfCenterLong,

                          double dfFalseEasting, double dfFalseNorthing );

void CPL_DLL OSRCleanup( void );

/* -------------------------------------------------------------------- */

/*      OGRCoordinateTransform C API.                                   */

/* -------------------------------------------------------------------- */

OGRCoordinateTransformationH CPL_DLL

OCTNewCoordinateTransformation( OGRSpatialReferenceH hSourceSRS,

                                OGRSpatialReferenceH hTargetSRS );

void CPL_DLL

      OCTDestroyCoordinateTransformation( OGRCoordinateTransformationH );

int CPL_DLL OCTTransform( OGRCoordinateTransformationH hCT,

                  int nCount, double *x, double *y, double *z );

int CPL_DLL OCTTransformEx( OGRCoordinateTransformationH hCT,

                            int nCount, double *x, double *y, double *z,

                            int *pabSuccess );

/* this is really private to OGR. */

char *OCTProj4Normalize( const char *pszProj4Src );

/* -------------------------------------------------------------------- */

/*      Projection transform dictionary query.                          */

/* -------------------------------------------------------------------- */

char CPL_DLL ** OPTGetProjectionMethods();

char CPL_DLL ** OPTGetParameterList( const char * pszProjectionMethod,

                             char ** ppszUserName );

int CPL_DLL OPTGetParameterInfo( const char * pszProjectionMethod,

                                 const char * pszParameterName,

                                 char ** ppszUserName,

                                 char ** ppszType,

                                 double *pdfDefaultValue );

CPL_C_END

#endif /* ndef _OGR_SRS_API_H_INCLUDED */