libgeotiff

geo_normalize.h

Go to the documentation of this file.
00001 /******************************************************************************
00002  * $Id: geo_normalize.h,v 1.13 2008/05/21 04:12:57 fwarmerdam Exp $
00003  *
00004  * Project:  libgeotiff
00005  * Purpose:  Include file related to geo_normalize.c containing Code to
00006  *           normalize PCS and other composite codes in a GeoTIFF file.
00007  * Author:   Frank Warmerdam, warmerda@home.com
00008  *
00009  ******************************************************************************
00010  * Copyright (c) 1999, Frank Warmerdam
00011  *
00012  * Permission is hereby granted, free of charge, to any person obtaining a
00013  * copy of this software and associated documentation files (the "Software"),
00014  * to deal in the Software without restriction, including without limitation
00015  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
00016  * and/or sell copies of the Software, and to permit persons to whom the
00017  * Software is furnished to do so, subject to the following conditions:
00018  *
00019  * The above copyright notice and this permission notice shall be included
00020  * in all copies or substantial portions of the Software.
00021  *
00022  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
00023  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
00024  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
00025  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
00026  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
00027  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
00028  * DEALINGS IN THE SOFTWARE.
00029  ******************************************************************************
00030  *
00031  * $Log: geo_normalize.h,v $
00032  * Revision 1.13  2008/05/21 04:12:57  fwarmerdam
00033  * added preliminary GTIFSetFromProj4() support
00034  *
00035  * Revision 1.12  2005/08/26 16:08:14  fwarmerdam
00036  * Include void in empty argument list for prototype.
00037  *
00038  * Revision 1.11  2004/02/03 17:19:50  warmerda
00039  * export GTIFAngleToDD() - used by GDAL mrsiddataset.cpp
00040  *
00041  * Revision 1.10  2003/01/15 04:39:16  warmerda
00042  * Added GTIFDeaccessCSV
00043  *
00044  * Revision 1.9  2003/01/15 03:37:40  warmerda
00045  * added GTIFFreeMemory()
00046  *
00047  * Revision 1.8  2002/11/28 22:27:42  warmerda
00048  * preliminary upgrade to EPSG 6.2.2 tables
00049  *
00050  * Revision 1.7  1999/09/17 00:55:26  warmerda
00051  * added GTIFGetUOMAngleInfo(), and UOMAngle in GTIFDefn
00052  *
00053  * Revision 1.6  1999/05/04 03:13:42  warmerda
00054  * Added prototype
00055  *
00056  * Revision 1.5  1999/04/29 23:02:55  warmerda
00057  * added docs, and MapSys related stuff
00058  *
00059  * Revision 1.4  1999/03/18 21:35:19  geotiff
00060  * Added PROJ.4 related stuff
00061  *
00062  * Revision 1.3  1999/03/17 20:44:04  geotiff
00063  * added CPL_DLL related support
00064  *
00065  * Revision 1.2  1999/03/10 18:24:06  geotiff
00066  * corrected to use int'
00067  *
00068  */
00069 
00070 #ifndef GEO_NORMALIZE_H_INCLUDED
00071 #define GEO_NORMALIZE_H_INCLUDED
00072 
00073 #include <stdio.h>
00074 #include "geotiff.h"
00075 
00076 #ifdef __cplusplus
00077 extern "C" {
00078 #endif
00079 
00086 #define MAX_GTIF_PROJPARMS      10
00087 
00092 typedef struct {
00095     short       Model;
00096 
00098     short       PCS;
00099 
00102     short       GCS;          
00103 
00105     short       UOMLength;
00106 
00108     double      UOMLengthInMeters;
00109 
00111     short       UOMAngle;
00112 
00114     double      UOMAngleInDegrees;
00115     
00117     short       Datum;
00118 
00121     short       PM;
00122 
00125     double      PMLongToGreenwich;
00126 
00129     short       Ellipsoid;
00130 
00132     double      SemiMajor;
00133 
00135     double      SemiMinor;
00136 
00138     short       ProjCode;
00139 
00142     short       Projection;
00143 
00147     short       CTProjection;   
00148 
00150     int         nParms;
00151 
00156     double      ProjParm[MAX_GTIF_PROJPARMS];
00157 
00160     int         ProjParmId[MAX_GTIF_PROJPARMS]; /* geokey identifier,
00161                                                    eg. ProjFalseEastingGeoKey*/
00162 
00165     int         MapSys;
00166 
00168     int         Zone;
00169 
00170 } GTIFDefn;
00171 
00172 int CPL_DLL GTIFGetPCSInfo( int nPCSCode, char **ppszEPSGName,
00173                             short *pnProjOp, 
00174                             short *pnUOMLengthCode, short *pnGeogCS );
00175 int CPL_DLL GTIFGetProjTRFInfo( int nProjTRFCode,
00176                                 char ** ppszProjTRFName,
00177                                 short * pnProjMethod,
00178                                 double * padfProjParms );
00179 int CPL_DLL GTIFGetGCSInfo( int nGCSCode, char **ppszName,
00180                             short *pnDatum, short *pnPM, short *pnUOMAngle );
00181 int CPL_DLL GTIFGetDatumInfo( int nDatumCode, char **ppszName,
00182                               short * pnEllipsoid );
00183 int CPL_DLL GTIFGetEllipsoidInfo( int nEllipsoid, char ** ppszName,
00184                                   double * pdfSemiMajor,
00185                                   double * pdfSemiMinor );
00186 int CPL_DLL GTIFGetPMInfo( int nPM, char **ppszName,
00187                            double * pdfLongToGreenwich );
00188 
00189 double CPL_DLL GTIFAngleStringToDD( const char *pszAngle, int nUOMAngle );
00190 int CPL_DLL GTIFGetUOMLengthInfo( int nUOMLengthCode,
00191                                   char **ppszUOMName,
00192                                   double * pdfInMeters );
00193 int CPL_DLL GTIFGetUOMAngleInfo( int nUOMAngleCode,
00194                                  char **ppszUOMName,
00195                                  double * pdfInDegrees );
00196 double CPL_DLL GTIFAngleToDD( double dfAngle, int nUOMAngle );
00197     
00198 
00199 /* this should be used to free strings returned by GTIFGet... funcs */
00200 void CPL_DLL GTIFFreeMemory( char * );
00201 void CPL_DLL GTIFDeaccessCSV( void );
00202 
00203 int CPL_DLL GTIFGetDefn( GTIF *psGTIF, GTIFDefn * psDefn );
00204 void CPL_DLL GTIFPrintDefn( GTIFDefn *, FILE * );
00205 void CPL_DLL GTIFFreeDefn( GTIF * );
00206 
00207 void CPL_DLL SetCSVFilenameHook( const char *(*CSVFileOverride)(const char *) );
00208 
00209 const char CPL_DLL *GTIFDecToDMS( double, const char *, int );
00210 
00211 /*
00212  * These are useful for recognising UTM and State Plane, with or without
00213  * CSV files being found.
00214  */
00215 
00216 #define MapSys_UTM_North        -9001
00217 #define MapSys_UTM_South        -9002
00218 #define MapSys_State_Plane_27   -9003
00219 #define MapSys_State_Plane_83   -9004
00220 
00221 int CPL_DLL   GTIFMapSysToPCS( int MapSys, int Datum, int nZone );
00222 int CPL_DLL   GTIFMapSysToProj( int MapSys, int nZone );
00223 int CPL_DLL   GTIFPCSToMapSys( int PCSCode, int * pDatum, int * pZone );
00224 int CPL_DLL   GTIFProjToMapSys( int ProjCode, int * pZone );
00225 
00226 /*
00227  * These are only useful if using libgeotiff with libproj (PROJ.4+).
00228  */
00229 char CPL_DLL *GTIFGetProj4Defn( GTIFDefn * );
00230 
00231 int  CPL_DLL  GTIFProj4ToLatLong( GTIFDefn *, int, double *, double * );
00232 int  CPL_DLL  GTIFProj4FromLatLong( GTIFDefn *, int, double *, double * );
00233 
00234 int  CPL_DLL  GTIFSetFromProj4( GTIF *gtif, const char *proj4 );
00235 
00236 #if defined(HAVE_LIBPROJ) && defined(HAVE_PROJECTS_H)
00237 #  define HAVE_GTIFPROJ4
00238 #endif
00239 
00240 #ifdef __cplusplus
00241 }
00242 #endif
00243     
00244 #endif /* ndef GEO_NORMALIZE_H_INCLUDED */

Generated for libgeotiff by doxygen 1.7.3