libgeotiff
|
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 */