classogrspatialreference.html

gdal库的学习文档

<p>
Initialize SRS based on EPSG GCS or PCS code.<p>
This code uses the GeoTIFF cpl_csv services to access the EPSG CSV data. If frmts/gtiff/libgeotiff isn't linked in, linking will fail. If EPSG tables can't be found at runtime, the method will fail.<p>
This method is the same as the C function OSRImportFromEPSG().<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>nCode</em>&nbsp;</td><td>a GCS or PCS code from the horizontal coordinate system table.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>OGRERR_NONE on success, or an error code on failure. </dd></dl>

</div>
</div><p>
<a class="anchor" name="f91af2639702e2793daf93ffe231b577"></a><!-- doxytag: member="OGRSpatialReference::importFromESRI" ref="f91af2639702e2793daf93ffe231b577" args="(char **)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OGRErr OGRSpatialReference::importFromESRI           </td>
          <td>(</td>
          <td class="paramtype">char **&nbsp;</td>
          <td class="paramname"> <em>papszPrj</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Import coordinate system from ESRI .prj format(s).<p>
This function will read the text loaded from an ESRI .prj file, and translate it into an <a class="el" href="classOGRSpatialReference.html">OGRSpatialReference</a> definition. This should support many (but by no means all) old style (Arc/Info 7.x) .prj files, as well as the newer pseudo-OGC WKT .prj files. Note that new style .prj files are in OGC WKT format, but require some manipulation to correct datum names, and units on some projection parameters. This is addressed within <a class="el" href="classOGRSpatialReference.html#f91af2639702e2793daf93ffe231b577">importFromESRI()</a> by an automatical call to <a class="el" href="classOGRSpatialReference.html#d556dfdc04d9ec5f1714fc6b5e0eb6a6">morphFromESRI()</a>.<p>
Currently only GEOGRAPHIC, UTM, STATEPLANE, GREATBRITIAN_GRID, ALBERS, EQUIDISTANT_CONIC, and TRANSVERSE (mercator) projections are supported from old style files.<p>
At this time there is no equivelent exportToESRI() method. Writing old style .prj files is not supported by <a class="el" href="classOGRSpatialReference.html">OGRSpatialReference</a>. However the <a class="el" href="classOGRSpatialReference.html#ac948450b15fa3d8814ab440b9f705b7">morphToESRI()</a> and <a class="el" href="classOGRSpatialReference.html#596b8e527d66a5054408159f0006fdac">exportToWkt()</a> methods can be used to generate output suitable to write to new style (Arc 8) .prj files.<p>
This function is the equilvelent of the C function OSRImportFromESRI().<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>papszPrj</em>&nbsp;</td><td>NULL terminated list of strings containing the definition.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>OGRERR_NONE on success or an error code in case of failure. </dd></dl>

</div>
</div><p>
<a class="anchor" name="52f1557adb638b64487afd9c430148f4"></a><!-- doxytag: member="OGRSpatialReference::importFromPCI" ref="52f1557adb638b64487afd9c430148f4" args="(const char *, const char *=NULL, double *=NULL)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OGRErr OGRSpatialReference::importFromPCI           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszProj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszUnits</em> = <code>NULL</code>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double *&nbsp;</td>
          <td class="paramname"> <em>padfPrjParams</em> = <code>NULL</code></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Import coordinate system from PCI projection definition.<p>
PCI software uses 16-character string to specify coordinate system and datum/ellipsoid. You should supply at least this string to the <a class="el" href="classOGRSpatialReference.html#52f1557adb638b64487afd9c430148f4">importFromPCI()</a> function.<p>
This function is the equilvelent of the C function OSRImportFromPCI().<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>pszProj</em>&nbsp;</td><td>NULL terminated string containing the definition. Looks like "pppppppppppp Ennn" or "pppppppppppp Dnnn", where "pppppppppppp" is a projection code, "Ennn" is an ellipsoid code, "Dnnn" --- a datum code.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pszUnits</em>&nbsp;</td><td>Grid units code ("DEGREE" or "METRE"). If NULL "METRE" will be used.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>padfPrjParams</em>&nbsp;</td><td>Array of 16 coordinate system parameters:</td></tr>
  </table>
</dl>
[0] Spheroid semi major axis [1] Spheroid semi minor axis [2] Reference Longitude [3] Reference Latitude [4] First Standard Parallel [5] Second Standard Parallel [6] False Easting [7] False Northing [8] Scale Factor [9] Height above sphere surface [10] Longitude of 1st point on center line [11] Latitude of 1st point on center line [12] Longitude of 2nd point on center line [13] Latitude of 2nd point on center line [14] Azimuth east of north for center line [15] Landsat satellite number [16] Landsat path number<p>
Particular projection uses different parameters, unused ones may be set to zero. If NULL suppliet instead of array pointer default values will be used (i.e., zeroes).<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>OGRERR_NONE on success or an error code in case of failure. </dd></dl>

</div>
</div><p>
<a class="anchor" name="ed106d3ccdc442209637b4368af0b370"></a><!-- doxytag: member="OGRSpatialReference::importFromUSGS" ref="ed106d3ccdc442209637b4368af0b370" args="(long, long, double *, long)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OGRErr OGRSpatialReference::importFromUSGS           </td>
          <td>(</td>
          <td class="paramtype">long&nbsp;</td>
          <td class="paramname"> <em>iProjSys</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">long&nbsp;</td>
          <td class="paramname"> <em>iZone</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double *&nbsp;</td>
          <td class="paramname"> <em>padfPrjParams</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">long&nbsp;</td>
          <td class="paramname"> <em>iDatum</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Import coordinate system from USGS projection definition.<p>
This method will import projection definition in style, used by USGS GCTP software. GCTP operates on angles in packed DMS format (see <a class="el" href="cpl__conv_8h.html#97b69cc886a1a5c9618612d8205600e4">CPLDecToPackedDMS()</a> function for details), so all angle values (latitudes, longitudes, azimuths, etc.) specified in the padfPrjParams array should be in the packed DMS format.<p>
This function is the equivalent of the C function OSRImportFromUSGS().<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>iProjSys</em>&nbsp;</td><td>Input projection system code, used in GCTP.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>iZone</em>&nbsp;</td><td>Input zone for UTM and State Plane projection systems. For Southern Hemisphere UTM use a negative zone code. iZone ignored for all other projections.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>padfPrjParams</em>&nbsp;</td><td>Array of 15 coordinate system parameters. These parameters differs for different projections.</td></tr>
  </table>
</dl>
<h4>Projection Transformation Package Projection Parameters</h4>
<p>
<pre>
 ----------------------------------------------------------------------------
                         |                    Array Element                  
  Code &amp; Projection Id   |---------------------------------------------------
                         |   0  |   1  |  2   |  3   |   4   |    5    |6 | 7
 ----------------------------------------------------------------------------
  0 Geographic           |      |      |      |      |       |         |  |  
  1 U T M                |Lon/Z |Lat/Z |      |      |       |         |  |  
  2 State Plane          |      |      |      |      |       |         |  |  
  3 Albers Equal Area    |SMajor|SMinor|STDPR1|STDPR2|CentMer|OriginLat|FE|FN
  4 Lambert Conformal C  |SMajor|SMinor|STDPR1|STDPR2|CentMer|OriginLat|FE|FN
  5 Mercator             |SMajor|SMinor|      |      |CentMer|TrueScale|FE|FN
  6 Polar Stereographic  |SMajor|SMinor|      |      |LongPol|TrueScale|FE|FN
  7 Polyconic            |SMajor|SMinor|      |      |CentMer|OriginLat|FE|FN
  8 Equid. Conic A       |SMajor|SMinor|STDPAR|      |CentMer|OriginLat|FE|FN
    Equid. Conic B       |SMajor|SMinor|STDPR1|STDPR2|CentMer|OriginLat|FE|FN
  9 Transverse Mercator  |SMajor|SMinor|Factor|      |CentMer|OriginLat|FE|FN
 10 Stereographic        |Sphere|      |      |      |CentLon|CenterLat|FE|FN
 11 Lambert Azimuthal    |Sphere|      |      |      |CentLon|CenterLat|FE|FN
 12 Azimuthal            |Sphere|      |      |      |CentLon|CenterLat|FE|FN
 13 Gnomonic             |Sphere|      |      |      |CentLon|CenterLat|FE|FN
 14 Orthographic         |Sphere|      |      |      |CentLon|CenterLat|FE|FN
 15 Gen. Vert. Near Per  |Sphere|      |Height|      |CentLon|CenterLat|FE|FN
 16 Sinusoidal           |Sphere|      |      |      |CentMer|         |FE|FN
 17 Equirectangular      |Sphere|      |      |      |CentMer|TrueScale|FE|FN
 18 Miller Cylindrical   |Sphere|      |      |      |CentMer|         |FE|FN
 19 Van der Grinten      |Sphere|      |      |      |CentMer|OriginLat|FE|FN
 20 Hotin Oblique Merc A |SMajor|SMinor|Factor|      |       |OriginLat|FE|FN
    Hotin Oblique Merc B |SMajor|SMinor|Factor|AziAng|AzmthPt|OriginLat|FE|FN
 21 Robinson             |Sphere|      |      |      |CentMer|         |FE|FN
 22 Space Oblique Merc A |SMajor|SMinor|      |IncAng|AscLong|         |FE|FN
    Space Oblique Merc B |SMajor|SMinor|Satnum|Path  |       |         |FE|FN
 23 Alaska Conformal